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ABSTRACT 


The  goal  of  this  work  is  to  develop  a  text-based  script  interpietadon  system  for  easy 
and  efficient  3D  visual  simulations  without  extensive  programming.  Scripts  are 
sequences  of  events  representing  task-level  behaviors  in  virtual  worlds  systems.  The 
Object  Animation  Script  Interpretation  System  for  NPSNET  (NPSNET-OASIS), 
provides  animators  at  the  Naval  Postgraduate  School  a  mechanism  for  interacting  with 
3D  visual  simulations  via  scripted  autonomous  players.  Libraries  of  scripts  are  collected 
for  rapid  generation  of  3D  visual  simulations.  NPSNET-OASIS  makes  use  of  object- 
oriented  design  methodologies  for  reusability  and  extensibility.  Included  in  NPSNET- 
OASIS  are  the  object  tools  for  script  processing,  writing,  and  sorting. 
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I.  THE  NEED  FOR  SCRIPT  ANIMATION  LANGUAGES 


A.  INTRODUCTION 

The  Graphics  and  Video  Laboratory  of  the  Computer  Science  Depanment  at  the 
Naval  Postgraduate  School  (NPS)  has  a  long  history  of  developing  3D  visual  simulation 
,  systems  on  inexpensive,  commercially  available  graphics  workstations  [Ref.  10].  The 

visual  simulators  developed  in  the  Graphics  and  Video  Laboratory  include  the  FOG-M 
missile  simulator,  the  VEH  vehicle  simulator,  the  Airborne  Remotely  Operated  Device 
(AROD),  the  Moving  Platform  Simulator  series  (MPS-1,  MPS-  2,  and  MPS-3),  the  High 
Resolution  Digital  Terrain  Model  (HRDTM)  system,  the  Forward  Observer  Simulator 
Trainer  (FOST)  the  NPS  Autonomous  Underwater  Vehicle  simulator  (NPSAUV),  and  the 
Command  and  Control  Workstation  ;r  the  Future  system  (CCWF).  Current  visual 
simulation  efforts  are  focused  on  the  NPSNET  system,  a  3D  visual  simulation  system  that 
utilizes  SIMNET  and  DMA  databases. 

NPSNET  is  a  real-time,  3D  visual  simulation  system  capable  of  displaying  various 
types  of  vehicles  -  ground,  ships,  and  aircraft  [Ref.  10].  The  system  is  capable  of 
displaying  additional  obiects  such  as  missiles,  buildings,  trees,  and  environmental  effects, 
such  as  fog  and  smoke.  Objects  are  represented  initially  by  pre-defined  3D  icons  stored  in 
Object  File  Format  (OFF)  [Ref.  9].  3D  icons  arc  geometric  descriptions  of  3D  objects. 
Vehicle  movements  in  NPSNET  are  controlled  by  mouse,  spaceballs,  and  button/ 

» 

dialboxes.  In  addition,  vehicles  can  be  driven  interactively  from  other  workstations  by 
*  means  of  message  packets  via  Ethernet. 

In  any  simulator,  the  backbone  of  the  system  is  its  internal  data  structures  for 
modeling  the  state  of  the  world  [Ref.  10].  It  is  from  the  world  state  information  that  visual 
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displays  are  generated.  Continuous  and  transient  events  are  referred  to  as  task-level 
behaviors  in  virtual  world  systems  [Ref.  1].  Continuous  events  are  dynamic  changes  in 
motion  of  3D  icons.  Transient  events  are  dynamic  changes  of  appearances  in  virtual  3D 
icons,  such  as  explosions  and  collisions. 

When  sufficient  numbers  of  actual  interactive  players  are  not  available,  the  Graphics 
and  Video  Laboratory  requires  two  methods  for  generating  autonomous  players  to 
populate  the  world  -  semi-automated  forces  and  scripting  [Ref.  10].  Currently  in 
development,  semi-automated  forces  provide  intelligent  behavioral  models  to  autonomous 
players  via  parallel  processing  and  the  network.  Scripting  provides  a  programmable 
mechanism  to  add  autonomous  agents  or  to  change  task-level  behaviors  of  3D  icons. 

The  script  system,  the  Object  Animation  Script  Interpretation  System  for  NPSNET 
(NPSNET-OASIS),  was  developed  to  meet  the  requirements  of  scripted  autonomous 
players.  Designed  using  object-oriented  methodologies,  NPSNET-OASIS  provides  the 
capabilides  to  record  and  playback  scripts  of  task-level  behaviors.  Scripts  in  NPSNET- 
OASIS  are  generated  as  sequences  of  events  in  uniform  order  based  on  dmestamps. 
Unlike  current  systems  which  arc  coded  in  standard  C,  NPSNET-OASIS  is  programmed 
in  C++,  thus  allowing  reusability  and  extensibility.  Several  instances  of  NPSNET-OASIS 
can  be  integrated  into  NPSNET,  allowing  the  simultaneous  execution  of  muluple  scripts. 

B.  BACKGROUND 

There  are  two  interaction  paradigms  in  virtual  world  systems  -  guiding  and 
programming  [Ref.  1].  Guiding  is  interaction  with  objects  from  built-in  procedural 
support  and  specially-designed  graphics  hardware.  Programming  is  interacdon  with 
objects  using  special-purpose  simulation  software  for  algorithmic  description  and  control. 

The  principles  of  software  engineering  are  applied  to  natural  script  languages  in  an 
effon  to  provide  a  more  flexible,  extensible,  and  efficient  interactive  tool  for  visual 
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simulates  [Ref.  5].  Libraries  of  scripts  can  be  generated  and  reused,  allowing  fast 
prototyping  of  simulated  engagements  and  tactics.  Simple  in  design  and  use,  scripts  are 
basically  procedures  for  controlling  3D  icons.  Combining  scripts  to  create  larger  ones, 
supports  modular  scripting  in  a  high-level  of  programming.  In  LISP-based  systnns,  the 
rules  of  the  script  language  are  extensible  so  that  new  animation  procedures  and  primitives 
can  be  added  to  the  system.  Easier  to  leam  than  complex  hnguages,  script  languages  can 
develt^  animation  scripts  faster  than  a  functionally  equivalent  Ada  or  C  program. 

The  basis  for  our  research  in  script  systems  is  on  three  earlier  systems  -  ASAS,  PDI, 
and  MANUS.  Based  on  the  LISP  language,  Acttx/ScriptCMr  Animation  System  (ASAS),  is 
a  full  programming  language  system  for  animation  and  graphics  [Ref.  6].  ASAS  supports 
independent  program  structures  called  actors,  and  includes  a  set  of  geometric  objects  and 
operattHS.  Geometric  objects  include  data  types  such  as  vectors,  colors,  polygons,  solids, 
and  lights.  Actors  ate  responsible  for  geometric  objects  in  an  animation  sequence. 
Geometric  operattHS  ate  the  tools  the  animattMr  uses  to  shqre,  ttrove,  and  orient  geometric 
objects. 

Influenced  by  ASAS,  Pacific  Data  Images  (PDI)  developed  a  script  system  on  top  of 
the  C  programming  language  for  creating  animation  in  the  entertainment  field  [Refs.  3, 5]. 
The  PDI  script  system  supports  complex  modeling,  transfcHmations,  and  motion.  At  each 
production  stage,  the  script  is  updated  to  reflect  production  changes,  and  to  incorpmte 
new  naodels  and  motion  data  from  other  parts  of  script  systeiri. 

BOLIO,  an  integrated  graphical  simulation  platform  (IGSP),  provides  users  tools  to 
interact  in  simulation  of  task-level  behaviors,  and  event-driven  processes  in  virtual  worlds 
[Refs.  1,  8).  A  compement  of  BOLIO,  MANUS,  provides  the  built-in  language  and 
processor  for  associating  objects  and  processes  in  defining  task-level  behaviws. 
Programmers  have  access  to  primitive  operations  of  kinematics  and  dynamics  in  a 
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modular  function  library.  Complex  scripts  are  used  for  testing  and  debugging  various- 
simulation  modules,  ot  for  deHning  vinual  environments 

C.  SUMMARY  OF  CHAPTERS 

The  development  of  NPSNET-  OASIS  involves  understanding  of  required  task-level 
behavievs  of  NPSNET  and  other  3D  visual  rimulators  of  the  Gnqrhics  and  Video 
Labmatory.  In  Chapter  II.  the  design  (A  the  script  system  is  discussed.  Chapter  III 
discusses  the  overview  of  NPSNET-OASIS.  The  interaction  of  NPSNET-OASIS  with 
NPSNET  is  discussed  in  Chapter  IV.  Limitations  and  future  directions  are  the  subjects  of 
Chapter  V.  Appendices  include  syntax  for  script  events  and  script  options.  listings  of 
script  results  and  script  errms.  sample  scripts,  and  object  class  descriptions  for  NPSNET- 
OASIS. 
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II.  DEVELOPMENT  OF  NPSNET-OASIS 


A.  DESIGN  CRITERIA 

The  goal  of  NPSNET-OASIS  is  to  build  a  scripting  system  that  is  reusable  and 
extensible.  In  addition,  NPSNET-OASIS  must  be  simple  for  system  integration.  Previous 
3D  visual  simulators  in  the  Graphics  and  Video  Laboratory  were  developed  with  traditional 
programming  languages  such  as  C,  and  are  not  easy  to  maintain.  Whenever,  a  modification 
is  made,  the  entire  system  is  affected.  The  design  of  NPSNET-OASIS  must  be  capable  of 
being  adapted  easily  as  modifications  are  made  to  NPSNET. 

B.  OBJECT-ORIENTED  DESIGN 

The  concept  of  object-oriented  design  (OOD)  involves  solving  problems  by 
identifying  the  real-world  objects  of  the  problem,  and  the  processing  required  of  those 
objects  [Ref.  2].  For  this  reason,  all  components  of  NPSNET-OASIS  are  represented  as 
objects.  Classes  in  object-oriented  design,  distinguished  in  italics  text,  are  templates  for 
categories  of  objects,  and  provide  the  means  for  creating  objects.  Because  objects  serve  as 
data  abstractions,  classes  must  include  data  structure  definitions  and  the  processing  code 
for  instances  of  those  data  structures. 

1.  Class  Hierarchy 

OasisObject  is  the  root  class  of  the  NPSNET-OASIS  class  hierarchy,  as  other  classes 
in  the  hierarchy  are  derived  from  it.  The  main  descendants  of  OasisObject  - 
OasisSystemObJect  and  OasisEventObJect,  represent  the  main  components  of  NPSNET- 
OASIS  (Figure  2.1).  OasisSystemObJect  represents  the  base  class  for  all  system 
components  in  script  processing,  script  generating,  and  script  sorting.  OasisEventObjects 
represents  the  base  class  for  all  task-level  behaviors  in  3D  icons.  For  illustrative  purposes. 
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classes  of  NPSNET-OASIS  are  segmented  from  the  total  class  hierarchy,  and  are 
represented  as  ellipses  with  arrows  pointing  to  descendants. 

2.  Event  Objects 

Each  ScriptEvent  is  composed  of  an  EventObJect,  EventPosition,  TimeStamp,  and 
Event  Attribute,  which  are  descendants  of  OasisEventObjects  (Figure  2.2).  EventObjects 
provide  identification  of  3D  icons  in  events,  and  EventPositions  provide  the  locations  of 
the  events.  For  every  ScriptEvent  there  is  a  TimeStamp,  which  provides  the  time 
mechanism  to  synchronize  all  events  in  uniform  order.  For  additional  information  in 
supporting  task-level  behaviors  of  3D  icons,  Event  Attributes  are  used  to  represent  the 
change  of  continuous  and  transient  events  (Figure  2.3). 

Presented  in  Figure  2.4  are  the  six  classes  of  script  events  -  VehicleEvent, 
WeaponEvent,  MiscObjectEvent,  EnvironmentEvent,  ScriptOption,  ScriptComment,  and 
ScriptOption.  ScriptComment  and  ScriptOption  do  not  represent  script  events.  However, 


Figure  2.1  Root  Class  of  NPSNET-OASIS  Class  Hierarchy 


6 


ObjectTrail 


^^^bjectExplosio^^ 


Figure  2.3  Descendants  of  Class  EventAttribute 


script  events  are  supported  by  them  for  descriptive  narrations  in  script  files  and  script 
synchronization.  Communicating  with  script  events,  ScriptObjects  are  the  interfaces  for 
passing  messages  of  task-level  behaviors  to  and  from  3D  icons.  ScriptObjects  interact  with 
virtual  world  systems  for  controlling  and  recording  continuous  and  transient  events. 

3.  System  Objects 

There  are  four  parent  classes  for  OasisSystem  -  ScriptFile,  ScriptProcessor, 
ScriptGenerator,  and  TimcKeeper  (Figure  2.5).  Classes  are  derived  from 
OasisSystemEvents  for  supponing  system  requirements  of  NPSNET-OASIS.  ScriptFiles 
provide  the  mechanism  for  interacting  script  files  with  script  systems.  EventProcessor  is 
the  base  class  for  the  required  event  processors  to  the  ScriptProcessor.  ScriptProcessor  is 
the  tool  for  interpreting  and  processing  of  all  script  files.  The  script  writer  of  NPSNET- 
OASIS,  the  ScriptGenerator,  records  all  script  objects  to  a  script  file.  The  last  parent  class, 
the  TimeKeeper,  provides  the  system  times  for  processing  and  recording  script  files. 
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Figure  2.5  Ancestors  and  Descendants  of  Class  OasisSystem 


Derived  from  OasisSystem,  are  two  additional  object  classes  for  NPSNET-OASIS 
(Figure  2,5).  OasisScriptPreprocessor,  is  a  preprocessor  for  validating  script  files  prior  to 
processing.  Script  errors  are  displayed  for  further  script  modification.  The  second  object 
class,  OasisScriptSorter,  provides  the  sorting  of  script  events  based  on  time  stamps.  This 
tool  ensures  all  script  events  are  in  unifoim  order. 
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C.  NPSNET-OASIS  SCRIPT  FORMAT 


All  script  files  for  NPSNET-OASIS  are  in  text-based  format  allowing  the  user  to  use 
any  standard  text-editor  for  script  editing  and  creation  (Figure  2.6).  It  is  easier  to  edit  task- 


Description: 
Host  Id  Munber: 
Simulator: 


Sample  script  of  two  M-1  tanks 
501 

NPSNET  on  IRIS  VOX  Workstation 


Author : 


Phillip  West 


A******************************************************************/ 


SCRIPT_TIME_REFERENCE  relative 
script" location  79A-DN 


/*  Activate  clouds  with  velocity  5.0  km/h,  heading  270.0  west  */ 
ENVIRONMENT  ACTIVATE  5010499  Cloud  270.0  5.0  34536783  1000.0  30.0 


/*  Activate  two  M-1  tanks  */ 

VEHICLE_ACTIVATE  5010001  Ml  090.0  40.0  345678  0.0  40.0 

VEHICLE  ACTIVATE  5010002  Ml  090.0  40.0  345678  0.0  45.0 


/*  Change  headings  of  M-1  tanks  */ 

VEHICLE_HEADING  5010001  135.0  344955  0.0  2:0.0 

VEHICLB~HEADING  5010002  120.0  345958  0.0  2:5.0 

/*  M-1  tanks  passing  by  a  palm  tree  */ 

OBJECT_ACTIVATE  5010003  PalmTree  345700  0  4:0.0 

OBJECTJ5EACTIVATE  5010003  5:35.0 

/*  Change  velocities  of  M-1  tanks  */ 

VEHICLE_SPEED  5010001  5.0  344801  0.0  6:0.0 

VEKICLB^PEBD  5010001  5.0  344803  0.0  7:25.0 

/*  M-1  tanks  passing  by  a  building  */ 

OBJECT_ACTlVATE  5010004  Building  345700  0.0  8:10.0 

OBJECT  DEACTIVATE  5010004  9:40.0 


/*  Deactivate  M  1  tanks  */ 

VEHICLE  J3EACT1VATE  5010001  9:45.0 

VEHICLE^DEACTIVATE  5010002  9:50.0 


/*  Deactivate  clouds  */ 

ENVIRONMENT  ACTIVATE  5010499  10:0.0 


/*  End  Of  Script  */ 


Figure  2.6  Sample  Script 


9 


level  behaviors  of  3D  icons  in  ASCII  text,  than  it  is  in  binary  format.  Each  script  statement 
is  required  to  be  on  a  separate  line.  Since  most  text  editors  are  capable  of  handling  lines  up 
to  132  columns,  there  is  no  reason  for  a  single  script  statement  to  not  fit  all  on  one  line. 
There  is  no  limit  on  number  of  lines  per  script  file. 

All  script  event  statements  in  NPSNET-OASIS  contain  a  procedural  operator  and  the 
required  arguments  for  the  procedural  operator  (Figure  2.7).  Procedural  operators  are 


OBJECT  ACTIVATE 

100  tree  79A-DM-123678  0.0  1:00._Q 

t 

Procedural 

t 

Arguments 

Operator 

Figure  2.7  General  Syntax  for  Script  Statements 


classified  into  five  groups  -  vehicle,  weapon,  object,  environment,  and  script.  All  NPSNET- 
OASIS  procedural  operators  begin  with  the  group  name  for  rapid  parsing  and  simplicity.  A 
listing  of  all  script  events  can  be  found  in  Appendix  A. 

In  the  interest  of  clarity  and  readability,  blank  lines  and  comments  are  permitted 
between  statements.  Comments  are  used  to  explain  or  describe  the  script  event.  Whenever 
the  symbol  7*’  is  encountered  on  a  line,  all  characters  from  that  point  on,  until  the  symbol 
is  reached,  is  considered  to  be  a  comment. 

Case  is  not  important  in  procedural  operators  and  required  arguments.  All  characters 
are  converted  to  lower  case  for  parsing  and  extraction.  The  only  time  case  is  important,  is 
when  characters  in  script  file  names  are  case  sensitive  for  UNIX  based  input  and  output 
disk  operations. 
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III.  OVERVIEW  OF  NPSNET-OASIS 
A.  SCRIPTING  TOOLS 

The  NPSNET-OASIS  system  communicates  with  three  scripting  tools  -  the  script 
processor,  the  script  generator,  and  the  timekeeper  (Figure  3.1).  Each  tool  is  independent  of 


Figure  3.1  The  NPSNET-OASIS  System 
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the  other.  The  integration  of  the  scripting  tools,  provides  animators  the  required 
mechanisms  to  record  and  playback  scripts. 

1.  Script  Processor 

Hidden  from  the  user,  all  functions  of  the  script  processor  are  accessed  from  the 
NPSNET-OASIS  system.  Functions  include  reading  script  objects  and  assigning  script  files 
to  process.  There  is  only  one  script  file  active  in  the  script  processor  at  any  given  instance. 
However,  multiple  processors  are  allowed.  On  end  of  file,  the  script  processor  can  be 
assigned  another  script  file  from  the  NPSNET-OASIS  system. 

The  script  processor  returns  a  script  result  after  each  read.  Script  results  are  based  on 
valid  script  statements  or  errors  reading  the  script  file.  File  errors  are  treated  as  :.nd  of 
scripts  or  inval?  i  script  files.  When  an  error  occurs  for  a  script  statement,  a  message  is 
displayed  on  the  standard  output  devi^'e  indicating  type  of  error .  followed  by  line  nui  .iber 
and  name  of  current  script  file  (Figure  3.2).  Messages  provide  users  a  tool  for  debugging 
scripts.  Description  of  script  results  and  script  errors  are  contained  in  Appendix  A. 


SCRIPT  ERROR;  Invalid  OASIS  Procedural  Operator 
fLincJLQI  of  file  *scrlPt.mr 

t  T  I 

Line  Number  Name  of  Script  File  Type  of  Error 


Figure  3.2  Error  Message 

Script  statements  are  read  in  line  for  line  by  the  script  processor.  When  blank  lines  are 
encountered,  tiie  script  processor  ignores  them,  and  continues  to  read  the  script  file. 
Beginning  with  the  symbol  V*’  script  comments  are  continuous  script  lines  containing 
information  about  script  events  or  script  options.  The  script  processor  treats  each  line  a«  a 
comment  until  the  termination  symbol  is  reached.  The  user  must  be  careful  in  using 
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script  comments.  A  script  comment  with  no  termination  symbol  will  include  valid  script 
events  until  end  of  file.  Script  lines  containing  script  events  or  script  options  are  valid  only 
when  both  procedural  operators  and  the  required  arguments  are  valid.  The  number  of 
arguments  for  each  procedural  operator  are  Hxed  Thus,  incomplete  or  extra  arguments  will 
make  the  script  line  invalid.  In  addition,  incomptete  format  of  a  required  argument  will 
preempt  an  error  message  by  the  script  processor. 

2.  Script  Generator 

The  script  generator’s  primary  purpose  is  to  write  script  objects  to  an  output  file  in 
NPSNET-CASiS  script  format.  Error  checking  does  not  exist  since  script  objects  contain 
default  values  for  all  values  not  assigned  in  even.  s.  All  script  Hies  generated  from  the  script 
generator  are  valid  files  for  script  processing.  When  several  script  files  exist,  a  library  can 
be  created  by  iiicluding  several  script  files  into  one  script.  There  are  no  specified  maximum 
number  of  lines  per  script  file.  The  only  limitation  is  the  space  available  on  disk. 

3.  System  Timekeeper 

As  timestamps  are  processed  for  each  script  event,  the  system  timekeeper  adjusts  them 
for  simulator  interaction.  Timestamps  for  each  script  event  are  assumed  relative  to  the  stan 
time  of  the  input  script  file.  When  absolute,  timestamps  are  relative  to  the  start  time  of 
NPSNET-OASIS  system.  The  timekeeper  uses  the  system  clock  of  the  graphics 
workstations  for  all  assignments  of  start  times.  Times  received  from  system  clocks  are 
based  on  total  seconds  and  total  microseconds  since  January  1, 1970  [^ef.  7]. 

There  are  two  types  of  clock  references  -  system  and  user.  The  difference  between  the 
two,  is  that  system  clock  reference  is  actual  system  time,  and  user  clock  reference  is  the 
time  selected  by  the  user  in  seconds  and  microseconds.  When  selected  in  user  clock 
reference,  the  user  has  the  option  to  change  the  start  time  for  the  NPSNET-OASIS  system. 
When  changed,  the  timekeeper  adjusts  the  new  start  time  with  the  system  clock.  In  addition, 
the  start  times  for  the  input  script  file  and  output  script  file  are  also  changed  to  the  same 
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start  time  as  the  NPSNBT-OASIS  system.  When  writing  script  files,  timestamps  are  always 
reference  to  the  stan  time  of  the  output  script  file. 

In  Figures  3.3  and  3.4,  timestamp  adjustments  are  illustrated  for  system  clock 
reference  and  user  clock  reference.  The  timestamp  is  converted  to  total  seconds  and  total 


Timestamp  of  10:01:05.5 

Tots*  Secs 

Usees 

665 

500000 

Timestamp  of  10:01:05.5 

Total  Secs 

Usees 

665 

500000 

System  Start  Time 

00:00:00  Sept  1, 1991 

Total  Secs 

Usees 

683697600 

500000 

Input  Script  Start  Time 
00:00:10  Sept  1, 1991 

Usees 

683697610 

100000 

Timestamp  in  Relative 

Total  Secs 

Usees 

683698266 

0 

Timestamp  in  Absolute 

Total  Secs 

Usees 

683698275 

Figure  3J  Illustration  of  Timestamp  Adjustment  Based  on  System  Clock 


Timestamp  in  Relative 

Total  Secs 

Usees 

665 

500000 

System  Start  Time 

Total  Secs 

Usees 

0 

0 

Timestamp  of  10:01:05.5 

Total  Secs 

Usees 

665 

500000 

Timestamp  in  Absrdute 

Total  Secs 

Usees 

675 

100000 

Input  Script  Start  Time 

Total  Secs 

Usees 

9 

Timestamp  of  10:01:05.5 

Total  Secs 

Usees 

665 

500000 

Figure  3.4  Illustration  of  Timestamp  Adjustment  Based  on  User  Clock 
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microseconds.  The  total  seconds  and  microseconds  are  used  for  timestamp  adjustments 
based  on  either  relative  or  absolute  time  reference.  In  relative  time  reference  with  the 
system  clock,  the  timestamp  is  added  to  the  start  time  of  the  input  script  file.  In  absolute 
time  reference,  the  timestamp  is  added  to  the  start  time  of  the  NPSNET-OASIS  system.  The 
same  procedure  is  also  applied  to  the  user  clock  reference. 

B.  STRUCTURE  OF  SCRIPT  EVENTS 

Each  script  event  has  a  3D  icon  identification,  a  position,  a  timestamp  and  attributes 
to  describe  a  task-level  behavior  event.  Users  of  NPSNET-OASIS  must  be  familiar  with 
the  data  structures  and  the  information  contained  in  them. 

1.  3D  Icon  Identification 

3D  icon  identifications  include  an  object  number,  a  host  number,  an  object  description, 
and  an  object  status.  Object  numbers  are  four  digit  values  assigned  to  3D  icons  by  the  visual 
simulator  to  distinguish  from  other  3D  icons.  Host  numbers  are  three  digit  values  used  in 
identifying  visual  simulators  in  a  netwoik.  When  combined,  a  host  number  and  an  object 
number  provide  an  unique  identification  number  to  a  3D  icon  (Figure  3.5).  Object 
descriptions  are  descriptive  names  of  3D  icons.  NPSNET  requires  them  for  associating 
OFF  files  for  visual  display.  Supplementing  world  state  information,  object  status  is  a 
description  of  the  current  state  on  a  3D  icon. 


501 1234 

„  ^  I  Object  Identification 

Host  Number  ◄§ — '  * 

Number 

Figure  3.5  The  3D  Icon  Identification  Number 
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2.  Event  Position  *  ' 

Positions  for  a  script  event  include  grid  coordinates  and  an  elevation.  Elevation, 
represented  in  meters,  is  the  altitude  of  an  area  above  sea  level.  The  primary  military  grid 
reference  system  in  the  United  States,  the  Universal  Transverse  Mercator  (UTM),  is  a 
world  wide  plane  coordinate  system  based  on  the  metric  standard  [Ref.  4].  The  grid 
coordinate  system  of  UTM  is  adopted  in  NPSNET-OASIS  (Figure  3.6).  Each  UTM  grid 
zone  is  a  square  area  of  six  degrees  in  longitude  by  eight  degrees  in  latitude.  UTM 
coordinates  are  designated  by  two  or  three  characters.  The  last  character,  in  alphabetic 
notation,  represents  the  latitude  offset,  and  the  beginning  characters,  in  numeric  notation, 
represents  the  longitude  offset.  To  further  identify  locations  in  each  UTM  grid  zone,  the 
U.S.  Army  created  the  MGRS  [Ref.  4].  MGRS  subdivides  UTM  grid  zones  into  100, 0(X) 
meter  square  areas  designated  by  two  letters.  To  complete  the  MGRS  grid,  UTM  easting 
and  northing  are  used  to  designate  which  square  meter  area.  Coordinates  are  in  even  digits 
where  the  tirst  half  representing  easting,  and  the  second  half,  northing.  Precision  in  UTM 
coordinates  requires  five  digits  for  easting  and  northing.  In  NPSNET-OASIS,  easting  and 
northing  coordinates  with  digits  less  than  five,  are  appended  with  additional  zeros  (Figure 
3.7). 


79A-DN- 12345 12345 

1“  1  1  1“ 


Gridzonc  MGRS  Easting  Northing 


Figure  3.6  UTM  Coordinate  Position 
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Appended  Zeros 

79A-DN-I23M  123^6 
“T  I  i 

Gridzmie  MGRS  Easting  Ncnthing 

Figure  3.7  UTM  Coordinate  Position  With  Padded  Zeros 

3.  Timestamp 

Timestamps  are  based  upon  the  24-hour  clock  metaphor  where  times  are  represented 
as  strings  [Ref.  1].  Each  Held  of  the  timestamp  string  is  represented  by  numeric  characters 
with  leading  zeros  being  optional.  In  Figures  3.8a-c,  hours,  minutes,  and  seconds  of  the 
timestamp  string  are  interpreted  from  right  to  left.  Microseconds  are  interpreted  from  left 
to  right  (Figure  3.8).  Used  in  event  scheduling,  timestamps  indicate  when  to  execute  the 
event.  In  time  delays,  timestamps  indicate  the  time  durations  of  the  script  pauses,  or  the 
time  to  begin  reading  scripts.  In  Figure  3.8,  timestamps  are  listed  in  formats  acceptable  to 
NPSNET-OASIS. 

4.  Event  Attributes 

Representing  properties  of  continuous  and  transient  events,  attributes  provide 
additional  information  on  script  events.  Attributes  enable  a  3D  icon  to  be  unique  among 
other  3D  icons  in  simulation.  Information  such  as  headings  and  velocities  of  3D  icons  are 
affected  by  state  changes  of  continuous  events.  Appearances  of  3D  icons  are  affected  by 
state  changes  of  transient  events.  An  exanqrle  of  a  transient  event  is  an  explosion  of  a  3D 
icon.  Hie  attributes  for  this  event  require  the  description  type  and  the  bounding  area  of  the 
explosion.  See  Appendix  I  for  description  of  event  attributes. 
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10:32:11.527501 

T  T 1 — r~ 

Hours  Minutes  Seconds  Nficroseconds 

43:22.230492 

T  T  “ir 

Minutes  Seconds  Microseconds 

33 . 540823 

T 

Seconds  Microseconds 

254904 


Mkroceconds 


Figure  3A  Timestamp  Formats 


C.  SCRIPT  OPTIONS 

Script  c^ons,  or  directives,  are  used  in  script  files  for  file  operations,  script  system 
defaults,  and  assigning  values  for  timestamp  adjustments.  From  Hguie  2.6,  die  soipt  is 
modified  to  include  all  the  script  cations  available  to  NPSNET-OASIS  (Figures  3.9  and 
3.10).  Syntax  for  each  script  option  is  listed  in  Appendix  A. 

1.  Script_Abort 

Noiniai  termination  of  NPSNET-OASIS  requires  all  statements  in  the  input  smpt  file 
to  be  process^.  However,  the  animator  has  the  option  to  terminate  the  script  by  inserting 
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/****** A******** *********************** A******* A***** A************** 

D««cziption:  Sasple  script  of  two  M-1  tanks  'script. ml' 

Host  Id  Kumbsr:  501 

Simulator:  NPSMET  on  IRIS  VGX  Workstation 

Author:  Phillip  Hast 

********************************************************************/ 

/*  Assign  tixDestasp  rafsronce  ralativa  to  start  time  of  input  script  */ 
SCRIPT^TZMESTAMP  ralativa 

/*  Assign  default  UTM  gridsona  and  MGRS  */ 

SCRIPT_LOCATION  IIS-DH 

/*  Assign  time  factor  of  50  percent  for  all  timestamps  */ 
SCR1PT_IIME_FACT0R  0 . 5 

/*  Assign  time  adjustment  value  of  10  seconds  for  all  timestaaps  */ 
SCRIPa?JPIME_AD  JUSTMENT  10.0 

/*  Activate  clouds  with  velocity  5.0  km/h,  heading  270.0  west  */ 
ENVIRONMBMT_ACIXVATE  5010500  Cloud  270.0  5.0  34536783  1000.0  30.0 

/*  Activate  two  M-1  tanks  */ 

VEHXCLE_ACIZVATE  5010001  Ml  090.0  40.0  344955  0.0  40.0 

VEHXCLE^ACTXVATE  5010002  Ml  090.0  40.0  345958  0.0  45.0 

/*  Change  headings  of  M-1  tanks  */ 

VBKXCLE_HBAOXK6  5010001  135.0  344801  0.0  2:0.0 

VEHXCuThEADXNG  5010001  120.0  344803  0.0  2:5.0 

/*  Change  velocities  of  M-1  tanks  */ 

VEHXCUE_SPEED  5010001  5.0  344670  0.0  6:0.0 

VEHXCLE^PEED  5010001  5.0  344677  0.0  7:25.0 

/*  M-1  tanks  passing  by  a  building  */ 

OBJBCTJICIXVATE  5010004  Building  344701  0.0  8:10.0 

OBJECT  J3BACTXVATE  5010004  9:40.0 

/*  Script  message  for  advance  warning  of  upcoming  script  events  */ 
SCRXPT__MBSSAGE  Activating  column  of  jeeps 

/*  Script  call  for  column  of  jeeps  */ 

SCRIPTJCALL  8cript-2.ffll 

/*  Continue  script  with  next  script  file  */ 

SCRZPTjCHAXN  Script-l.ml 


Figure  3.9  Sample  Script  With  Script  Options 
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Description:  Sasple  script  of  two  M-1  tanks  'script-1. ml' 

Host  Id  Number:  501 

Simulator:  NPSNET  on  IRIS  VGX  Workstation 

Author:  Phillip  West 

********************************************************************/ 
/*  M-1  tanks  passing  by  a  palm  tree  */ 

OBJECT_ACTIVAIE  5010003  PalmTree  345700  0.0  22:0.0 

OBJSCTJ>BACTXVATB  5010003  22:35.0 

/*  Change  velocities  of  M-1  tanks  */ 

VEHZCLI^SPEEO  5010001  5.0  345670  0.0  26:0.0 

VBHZCZ.B~SI*EBI>  5010001  5.0  345677  0.0  27:25.0 

/*  Deactivate  M  1  tanks  */ 

VEHZCLBJDEACIXVATE  5010001  29:45.0 

VEHICLE J5'^CTIVATE  5010002  29:50.0 

/*  Deactivate  clouds  */ 

ENVIROMMBNT_ACIIVATB  5010500  30:0.0 

/*  Script  delay  for  duration  of  5  minutes  prior  to  termination  */ 
SCRIPtJDELAY  5:0.0  absolute 

/*  Write  to  output  script  file  message  for  next  script  processing  */ 

SCRIPTjriLEJMRITB  SCRXPTJKESSA6E  End  Of  Script 

/*  Terminate  script  */ 

SCRIPT  ABORT 


/AAA******** *********************** A*** ********************* A******* 

Description:  Saiiple  script  of  multiple  jeeps  'script-2. ml' 

Host  Id  Number;  501 

Simulator:  NPSNET  on  IRIS  VOC  Workstation 

Author :  Phillip  West 

********************************************************************/ 
/*  Activate  jeep  vehicle  */ 

VEHICLE_ACTIVATE  5010010  Jeep  090.0  40.0  345678  0.0  10:0.0 

I*  Repeat  script  for  10  Iterations  with  total  11  separate  vehicles  *! 
SCRIPT  REPEAT  10  1  1:0.0 


Figure  3.10  Sample  Script  With  Script  Options 
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SCRIPT^ABORT.  TTiis  script  directive  has  no  arguments.  When  encountered,  all  script 
files  are  closed,  and  a  script  result  of  END_OF_SCRIPT  is  returned  to  the  system. 

2.  Script_Call 

The  directive  SCRIPT_CALL  is  a  subscript  call,  similar  to  a  procedure  call  in  a  high- 
level  programming  language.  The  argument  for  this  directive  is  a  string  containing  the 
script  file  name.  The  calling  script  file  is  suspended  during  processing  of  the  subscript  and 
control  returns  on  subscript’s  end  of  file.  This  directive  supports  modular  scripting  in 
NPSNET-OASIS. 

3.  Script_Chain 

Linking  of  one  input  script  file  to  another  requires  the  script  directive 
SCRIPT-CHAIN.  The  required  argument  is  a  string  containing  the  script  file  name.  After 
the  chained  script  file  is  successfully  opened,  the  other  script  file  is  closed.  This  directive 
is  useful  for  combining  small  script  files  into  one  large  script. 

4.  Script_Repeat 

Similar  to  a  counter-controlled  loop,  the  script  directive  SCRIPT^REPEAT  allows 
scripts  to  be  processed  repeatedly.  There  are  three  arguments  for  SCRIPT_REPEAT  - 
iterations,  object  number  adjustment,  and  timestamp  adjustment.  Iterations  are  values  for 
the  number  of  times  repeating  the  same  script.  Object  number  adjustment  is  the  increment/ 
decrement  value  for  all  3D  icon  identification  numbers.  Similar  to  the  script  option 
SCRIPT_TIME_ADJUSTMENT,  timestamp  adjustment  is  .the  increment/decrement  of 
timestamps  for  each  repeated  script  event.  All  script  events  in  script  chains  and  script  calls 
are  affected  by  SCRIPT_REPEAT.  This  directive  is  useful  for  repeating  the  entire  script, 
or  repeating  a  short  series  of  script  events. 

5.  Script^Timestamp 

SCRIPT_TIMESTAMP,  with  the  selected  string  as  argument,  is  used  to  change  time 
reference  in  script  processing.  The  default  time  reference  for  NPSNET-OASIS  system  is 
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“relative”.  The  other  option  is  “absolute”.Relative  time  reference  is  for  all  timestamp- 
adjustments  based  on  input  script  start  time.  Absolute  time  reference  is  for  all  timestamp 
adjustments  based  on  system  start  time. 

6.  Script_Time_Adjustinent 

Changing  event  timestamps  throughout  the  script  requires 
SCRIPT_TIME_ADJUSTMENT  to  be  inserted  prior  to  selected  statements.  An  argument 
in  timestamp  format,  is  used  for  adding  to  event  timestamps.  To  stop  timestamp 
adjustments,  requires  another  SCRIPT_TIME_ADJUSTMENT  and  an  argument  of  zero. 

7.  Script_Time_Factor 

Another  option  for  adjusting  timestamp,  is  the  use  of  SCRIPT_TIME_FACTOR. 
With  a  floating-type  numeric  argument,  SCRIPT_TIME_FACTOR,  provides  the  time 
factor  percentage  for  each  event  timestamp.  This  option  is  useful  for  incrementing  or 
decrementing  speed  of  script  processing.  For  example,  the  value  of  2.0  causes  two  seconds 
of  script  time  to  be  four  seconds  of  wall  clock  time. 

8.  Script_Delay 

There  are  two  arguments  required  for  SCRIPT_DELAY  -  timestamp  and  delay  type. 
Delay  type  is  either  “absolute”  or  “relative”.  In  absolute  mode,  the  current  script  is 
suspended  until  the  time  specified  by  the  timestamp.  In  relative  mode,  the  current  script  is 
suspended  for  the  time  duration  specified  by  the  timestamp, 

9.  Script_Location 

Upon  initialization,  the  NPSNET-OASIS  system  assigns  the  default  UTM  gridzone 
and  MORS  with  strings  “lOS”  and  “DN”  respectfully.  Defaults  will  be  assigned  when  an 
UTM  gridzone  and/or  MGRS  are  not  included  in  the  event  position.  Replacing  one  or  both 
system  defaults  requires  SCRIPT_LOCATION  to  be  used  in  tlie  script. 
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10.  Script_File_Write 

Script  objects  recorded  to  an  output  script  file  include  script  events  and  script 
comments.  There  are  no  script  options  or  blank  lines.  SCRIPT_FILE_WRITE  provides 
animators  the  capability  to  include  any  type  of  script  statements  in  arec(n*ded  script.  If  there 
is  no  output  script  file,  then  an  error  message  is  displayed. 

11.  Script_Message 

While  developing  software,  programmers  include  statements  in  their  source  code  for 
tracing  and  debugging.  In  NPSNET-OASIS,  animators  have  the  same  capability  by 
allowing  script  messages  to  be  displayed  on  a  standard  output  device.  Messages  can  include 
any  text  desired  by  the  animator.  One  suggestion  is  to  use  script  messages  prior  to  selected 
script  events.  Messages  with  information  on  upcoming  events  provide  advanced  warning 
of  what  to  expect  in  visual  simulation. 
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IV.  IMPLEMENTATION  OF  NPSNET-OASIS 


A.  OVERVIEW 

The  current  NPSNET  system  runs  across  the  entire  Silicon  Graphics,  Inc.  (SGI)  IRIS 
4D  line  [Ref.  10].  NPSNET-OASIS  was  developed  with  no  graphics  function  calls,  thus 
allowing  application  on  various  types  of  platforms  including  non-graphics  workstations. 
Networking  allows  the  different  platforms  to  interact  on  other  workstations  in  the 
Graphics  and  Video  Laboratory. 

For  autonomous  vehicle  control,  the  network  harness  process  of  NPSNET  enables 
NPSNET-OASIS  to  provide  scripted  autonomous  players  in  visual  simulation  [Ref.  10]. 
The  network  harness  uses  Ethernet  TCP/IP  multicast  packets  designed  for  the  NPSNET 
system.  The  purpose  of  this  process  is  to  listen  to  the  packets  broadcast  on  the  network  and 
to  build  an  internal  model  of  the  state  of  the  world  from  those  packets.  Script  events  from 
NPSNET-OASIS  arc  transformed  to  message  packets  and  broadcasted  via  the  network 
harness.  In  addition,  packets  received  are  transformed  and  recorded  to  an  output  script. 

B.  DATA  STRUCTURES 

The  data  sMictures  required  for  the  script  event  and  message  packet  transformations 
are  contained  in  Appendices  I  through  K.  Currently  in  NPSNET,  only  vehicle  script 
events  are  used  for  autonomous  vehicle  control.  As  further  development  of  NPSNET 
continues,  other  script  events  are  integrated  to  allow  enhanced  modeling  of  the  world. 

C.  NPSNET-OASIS  NETWORK  INTERFACE 

As  shown  in  Figure  4.1,  NPSNET-OASIS  is  integrated  into  NPSNET  by  coupling 
with  the  NPSNET-OASIS  network  interface.  The  network  interface  provides  the 
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Figure  4.1  NPSNET-OASIS  Network  Interface 


synchronization  in  playbacks  and  recordings  of  NPSNET-OASIS  scripts.  Using  the 
required  data  structures,  transformations  of  all  script  event  message  packets  are  processed 
in  the  network  interface. 

1.  Internal  Data  Structures 

Several  NPSNET-OASIS  network  interfaces  can  interact  with  NPSNET  with  each 
containing  its  own  internal  data  structures  for  representing  the  state  of  the  world.  Referred 
to  as  the  local  state  of  the  world,  the  data  structure  contains  all  locations  and  vehicle  types 
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for  NPSNET-OASIS.  Additionally,  another  internal  data  structure  is  used  for  indicating 
which  vehicle  icons  are  recorded  on  script.  First  time  script  events  of  vehicle  icons 
require  the  script  event  VEHICLE_ACTIVATE  to  be  recorded  on  script.  Playback  of 
scripts  requires  VEHIQ-.E_ACnVATE  to  set  the  vehicle  attribute  alive  for  the  vehicle 
icon  to  be  active  in  NPSNET.  The  network  interface  updates  the  local  data  structures  prior 
to  each  message  broadcast  and  prior  to  recording  on  script. 

2.  Message  Packets 

Currently  there  is  only  one  type  of  message  packet  used  in  NPSNET  for  scripted 
autonomous  players  -  vehicle  update.  Each  vehicle  script  event  is  processed  as  a  vehicle 
update  regardless  of  event  type.  The  encoding  of  the  message  packet  is  described  in 
Appendix  K. 

There  are  three  types  of  message  packets  received  from  the  network  -  stop  script, 
time  synchronization,  and  vehicle  update.  Stop  script  message  enables  the  NPSNET- 
OASIS  network  interface  to  detach  from  the  network.  Time  synchronization  message 
assigns  the  initial  start  time  of  NPSNET.  NPSNET-OASIS  sets  all  start  times  of  script 
files  and  script  system  to  the  time  specified  in  the  message.  Vehicle  update  message  is 
used  to  update  the  local  state  of  the  world  and  to  record  the  script  event. 

3.  Operation  of  Network  Interface 

Referring  to  Figure  4.2,  the  NPSNET-OASIS  network  interface  is  operational  until 
end  of  input  script  file  or  a  stop  script  message  packet.  If  the  network  interface  was 
initialized  with  no  input  script  file,  then  a  stop  script  message  is  required.  Prior  to  reading 
script  events,  the  network  is  checked  for  incoming  message  packets.  When  message 
packets  exist,  the  local  state  of  the  world  is  updated  and  the  transformed  script  events  are 
recorded.  All  script  events  from  the  input  script  file  are  transformed  to  message  packets 
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and  sent  to  the  network.  System  time  for  NPSNET-OASIS  is  based  on  the  user  clock 
reference. 
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void  MonitorNpsnetNetworkQ  { 

AddProcessToNetworkO; 

SetSystemStartTime(StartTicks  /  HZ,  StartTicks  %  HZ); 

while(ActiveNetworkInterface)  { 

C’irrentTicks  =  (times(&SysTimes)  -  StartTicks); 

ReceiveAndProcessMessagesO; 

if(InputScriptExists  &&  ActiveNetworkInteiface)  { 

ReadAndProcessScript£vent(CurrentTicks,  VehicleArray) ; 

switch(GetScriptResult())  { 
case  END_OF_SCRIPT: 

InputScriptExists  =  FALSE; 
if( !  OutputSciiptExists) 

ActiveNetworklnterface  =  FALSE; 
break; 

caseSCRIPT.VALID: 

WriteScriptMessage(GetIconID(),  GetEventIDO); 

SendUpdateMessage(GetIconID()); 

break; 

case  SCRIPT.ERROR: 
case  SCRIPT_IN_DELAY: 
case  NO_SCRIPT_EVENT: 
default; 
break; 

}  //  end  switch 

}  //  endif 

}  //endloop 

DetachProcessFromNetworkO; 

//  end  MonitorNpsnetNetwork 

Figure  4.2  Network  Interface  Monitor  Routine 
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V.  CONCLUSIONS  AND  RECOMMENDATIONS 


A.  SUMMARY  AND  CONCLUSION 

The  NPSNET-OASIS  system  has  fulfilled  the  initial  requirement  of  providing  tools  to 
record  and  playback  scripts.  The  NPSNET-OASIS  network  interface  provides  users  of 
NPSNET  the  capability  to  generate  scripted  autonomous  players  in  visual  simulations. 
The  study  in  applying  object-oriented  methodologies  in  a  practical  design  such  as 
NPSNET-OASIS  was  beneficial  for  extensibility  and  reusability  of  existing  source  code. 
This  was  proven  when  the  network  interface  for  NPSNET-OASIS  was  built  on  top  of  a 
script  system.  As  new  software  developments  evolve  in  the  Graphics  and  Video 
Laboratory,  changes  can  be  made  in  NPSNET-OASIS  with  little  modifications. 

B.  LIMITATIONS 

There  are  two  limitations  in  NPSNET-OASIS.  First,  using  the  classes  of  NPSNET- 
OASIS  requires  C++  throughout  software  development.  Exisdng  software  in  the  Graphics 
and  Video  Laboratory  such  as  NPSNET  must  be  converted  to  C++  in  order  to  fully 
integrate  NPSNET-OASIS  in  code.  The  second  limitation  is  that  NPSNET  is  currently 
unable  to  use  all  the  script  events  in  NPSNET-OASIS.  The  data  structures  for  NPSNET 
are  limited  in  containing  the  information  for  all  types  of  continuous  and  transient  events. 
In  addition,  the  capabilities  for  transient  events  such  as  collisions  and  explosions  are  still 
under  development.  Current  design  of  the  NPSNET-OASIS  network  interface  permits  only 
continuous  events  of  vehicle  icons,  such  as  vehicle  heading  and  velocity  changes. 

C.  FUTURE  DIRECTIONS 

Current  implementations  of  NPSNET-OASIS  are  in  executable  load  modules  with  no 
graphics  functions.  Execution  of  load  module  requires  Qrping  the  module  name  at  the 
command  prompt.  There  are  no  output  displays  other  than  error  messages  generated  during 
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processing  and  recording  of  scripts.  Future  effort  could  be  placed  on  developing  some 
interactive  tool  for  using  the  script  tools  of  NPSNET-OASIS,  such  as  a  graphics  script 
editor  or  a  syntax  directed  editor. 

The  NPSNET-OASIS  network  interface  is  implemented  only  for  the  SGI  IRIS 
graphics  workstations.  Porting  the  software  to  other  platforms  should  be  an  easy  matter. 
Suggestion  is  to  naodify  the  source  code  of  NPSNET-OASIS  for  providing  scripted 
autonomous  players  from  a  different  platform. 
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APPENDIX  A 

NPSNET-OASIS  Script  Events,  Results,  and  Errors 


Note:  Back  slashes  V  in  syntax  or  examples  indicate  continuation  on  the  same  line. 

Vehicle  Events 

<vehicle  number>  <type  description>  <heAding>  \ 
<velocity>  <UTM  coordinates>  <elevation>  \ 
<timestamp> 

Description  -  New  vehicle  icon  activated  for  visual  simulation. 

Example-  VEHICLE_ACTXVATE  200  hi  235.0  5.0  1234567890  0.0  5:0.0 

VEHICLB_DEACTIVATE 

VEHICLEJDEACTIVATE  <vehicle  number>  <timestamp> 

Description  -  Vehicle  icon  deactivated  from  visual  simulation. 

Example-  vehicle_deactivate  200  5: 0.0 


VEHICLE_ACTIYATE 

VEHICLE  ACTIVATE 


VEHICLE  J40DIFICATI0M 

VEHICLE_MODIFICATION  <vehicle  number>  <componcnt  name>  \ 

Krotation  X  di recti on>  \ 

<rotation  Y  direction>  <rotation  Z  direction>  \ 
<translation  X  direction> 

<translation  Y  direction>  \ 

<translation  z  direction>  <UTM  coordinates>  \ 
<elevation>  <timastamp> 

Description  -  Vehicle  icon  is  modified  by  changing  the  degrees  of  freedom  on  one  of  it’s 
components. 
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Example*  VEHICLE_H0DIFICATX0N  200  turret  10.0  10.0  10.0  25.0  25. 0\ 
25.0  1234567890  0.0  5;0.0 

VEHICLE_PITCH 

VEHICLE_PITCH  <vehicle  /)u-.>uer>  <pitch  angle>  <UTM  coordinates>\ 

<elevation>  <t£mestanp> 

Description  -  Pitch  angle  of  vehicle  icon  is  changed.  Negative  values  indicated  downward 
angle  and  positive  values  indicate  upward  angle. 

Example-  VEHICLE_PITCU  200  10.0  1234567890  0.0  5:0.0 

VEHICLE_ROLL 

VBHICLE__ROLL  <vehicle  nu/nber>  <roll  angle>  <roll  clirection>  \ 

<UTM  coordinates>  <elevation>  <timestatip> 

DescripUmi  •  Roll  angle  of  vehicle  icon  is  changed.  The  diF»:tion  of  the  roll  is  either 
’stbd’,  ’pon’,  or  ’none’.  Direction  ’mme’  indicates  a  roll  angle  of  0.0. 

Examples-  VEHICI,E_R01L  200  10.0  stbd  1234567890  0.0  5:0.0 
VEHICtEJROLL  200  10.0  port  1234567890  0.0  5:0.0 
VEHICLEJiOLL  200  0.0  none  1234567890  0.0  5:0.0 

VSBICLE_POSITIOM 

VBHlCLE_POSITlON  Kvehicle  number>  <UTM  coordinates>  <elevation>  \ 

<timestawp> 

Description  -  The  position  of  vehicle  icon  is  updated. 

Examples-  VEHICLEJPOSITIGH  200  79A-DN-1234567890  0.0  5:0.0 
VEHICLE_POSITIOR  200  79h~1234567890  0.0  5:0.0 
VEHICl,E_POSITION  200  DN-1234 567890  0.0  5:0.0 
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VIBICLE  HEADING 


VEHICLE_HEADING  <vehicle  number>  <heading>  <UTM  coordinates>  \ 

<elevation>  <timestamp> 

Description  •  The  heading  of  vehicle  icon  is  changed.  All  headings  are  from  0.0  to  359.9 
degrees  relative  to  North.  For  NPSNET,  degrees  are  required  to  be  in  radians. 

Example  •  VEHICLE_HEADING  200  270.  0  79A-‘DN-1234567890  0.0  5:0.0 

VEHICLE_SPEED 

VEHICLEJSPEED  <vehicle  numberP  <velocity>  <UTM  coordinates>  \ 

<elevation>  <timestanip> 

Description  -  The  velocity  of  vehicle  icon  is  changed.  All  velocities  are  in  kilometers  per 
hour. 

Example*  VEHICLE_SPEED  200  10.0  79A-DN-1234567890  0.0  5:0.0 


VSBICLE_TRAIL 

VBHICLE_TRAIL  <vehicle  nttmber>  <tTail  description>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  direction>\ 

<bound  area  Y  direction>  <offset  X  direction>  \ 
<offset  Y  direction>  <offset  Z  direction>  \ 

<UTM  coordinates>  <elevation>  <timestamp> 

Description  -  The  trail  of  vehicle  icon  is  activated  for  visual  simulation.  Trails  such  as  dust 

or  wake  requires  attributes  for  bounding  area  for  size  and  vehicle  offset. 

Example-  vehicle_trail  200  mediumdust  10. 0  10.  o  'lo.o  0.0  0.0  o.o\ 
1234567890  0.0  5:0.0 


VEHICLE_COLLISION 

VEHICLE_COLLISION  <vehicle  nuniber>  <description  result>  \ 

<UTM  coordinates>  <elevation>  <timestamp> 
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D^cription  -  This  event  is  a  transient  event  indicating  vehicle  icon  collision  with  another  • 
icon. 

Example  -  VEHICLE__C0LLJSI0N 200  destroyed  79A-DN-1234567890  0.0  5:0.0 


VEHICLE_EXPLOSIOM 

VEHICLE_EXPLOSION  <vehicle  number>  <explosion  description>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  direction>  \ 

<bound  area  Y  direction>  <UTM  coordinates>  \ 
<elevation>  <timestanp> 

Description  -  This  event  is  a  transient  event  of  a  vehicle  icon  explosion.  Attributes 
required  are  explosion  type  and  bounding  area  for  explosion. 

Example-  VEHICLE^EXPLOSION  200  largescale  10.0  10.0  10.0  1234567890\ 

0.0  5;o7o 


VEHICLS:_PIAMING 

VEHICLBjFLMiWG  <vehicle  namber>  <description  of  fire>  \ 

<bound  area  X  direction>  \ 

<bovnd  area  Y  direction>\ 

<bound  area  Y  direction>  <offset  X  direction>  \ 
<o£fset  Y  direction>  <offset  Z  direction>  \ 
<UTM  coordinates>  <elevation>  <timestamp> 


Description  -  This  event  is  a  transient  event  of  a  vehicle  icon  on  fire.  Attributes  required 

are  type  of  flames,  bounding  area  of  the  flames,  and  the  vehicle  offset  to  the  flames. 

Example-  VEHICLE_FLAMING  200  mediumflame  10.0  10.0  10.0  0.0  0.0  0.0\ 
1234567890  0.0  5:0.0 


V1BICLE_SM0KING 

VEHICLE_SM0KING  <vehicle  number>  <description  of  smoke>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  directlon>  \ 

<boMnd  area  Y  direction>  <offset  X  direction>  \ 
<offset  Y  direction>  <offset  Z  direction>  \ 
<UTM  coordinates>  <elevation>  <timestamp> 
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Description  -  Hiis  event  is  a  transient  event  of  a  vehicle  icon  emitting  smoke.  Attributes 

required  are  smoke  type,  bounding  area  of  the  smoke,  and  the  vehicle  offset  to  the  smoke. 

Example*  VEHICLB_SMOKim  200  medivmsmoke  10.0  10.  0  10.0  0.0  0.0  0.0\ 
1234567890  0.0  5:0.0 

VEHICLE_DESTROYED 

VBHICLE__DESTROYED  <vehicle  number>  <UTM  coordinates>  <elevation>  \ 

<timestamp> 

Description  -  Not  removed  from  visual  simulation,  the  vehicle  icon  is  destroyed. 
Example*  VEHICLE_DESTR0YED  1234567890  0.0  5:0.0 

VEHICLE__FUEL 

VBHICLE_FUEL  <vehicle  number>  <fuel  amount>  <timestamp> 

Description  *  The  fuel  state  is  changed  on  a  vehicle  icon.  Amount  of  fuel  left  in  vehicle 
icon  is  indicated  in  liters. 

Example*  vehicle_fuel  200  10.0  5: 0.0 

VEHICLEJtMMUNITION 

VEHICLE_AMMUNITION  <vehicle  number>  <weapon  name>  <weapon  rounds>  \ 

<timestamp> 

Description  -  The  ammunition  state  is  changed  on  a  vehicle  icon.  Weapon  rounds  of 
weapon  name  indicate  current  number  assigned  to  the  vehicle  icon. 

Example*  VEHICLE_AmUNITION  200  turret  10  5:0.0 

VEHICLE_OPDATE 

VEHICLEJUPDATE  <vehicle  number>  <vehicle  status>  <heading>  \ 

<velocity>  <pitch  angle>  <roll  angle>  \ 

<roll  direction>  <UTM  coordinates>  <elevation>  \ 
<timestamp> 
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Description  -  Update  status  on  a  vehicle  icon. 

Example*  VEHICLE_UPDATE  200  inmotion  260.0  10.0.0  0.0  none  456789\ 
0.0  5:0.0 

VEHICI£__STATUS_QUERY 

VEHICLE^STATUS_QUERy  <vebicle  number>  <timestamp> 

Description  -  This  event  queries  status  of  a  selected  vehicle  icon. 

Example*  vehiclb_status_qubry  200  5: 0.0 

Weapon  Events 

WEAPON^LAUNCH 

ffEAPON_LAUNCH  <weapon  number>  <source  id>  <description>\ 

<heading>  <heading  type>  <velocity>  \ 

<pitch  angle>  <VTM  coordinates>  <elevation>  \ 
<timestamp> 

Description  -  Weapon  is  launch  from  a  source  vehicle  icon  with  initial  velocity  and 

headings.  Headings  are  indicated  in  relative  ’R’  or  absolute  ’A’. 

Examples*  WBAP0N_LAUNCH  300  200  sm-2  26O.O  a  boo,  9  45.0  456789  3.0\ 
5:0.0 

WEAPON_LAUNCH  300  200  sm-2  260.0  R  500.9  45.0  456789  3.0\ 
5:0.0 

ffEAP0N_IMPAC7 

tiEAPON_lMPACT  <weapon  number>  <source  id>  <UTM  coordinates>\ 

<eIevation>  <timestamp> 

Description  -  Weapon  impact  terminating  weapon  icon. 

Example*  NBAP0N_IMPACT  300  200  456789  3.0  5:0.0 
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¥?EAPON_EXPLOSION 

WEAPON_EXPLOSION  <weapon  nuwber>  <source  id>  <UTM  coordinates>  \ 

<elevation>  <timestamp> 

Description  -  Weapon  explosion  terminating  weapon  icon. 

Example*  meapon_explosion  300  200  456789  3.0  5: 0.0 


WEAPOM__nPDATE 

WEAPON_UPDATB  <weapon  number>  <source  id>  <weapon  status>  \ 

<heading>  <heading  type>  <velocity>  \ 

<pitch  angle>  <UTM  coordinates>  <elevation>  \ 
<timestamp> 

Description  -  Update  status  on  a  weapon  icon. 

Examples*  WEAP0N_UPDATE  300  200  active  26O.O  a  300.0  35.0  456789  3.0  5:0.0 
WEAPON_UPDATE  300  200  active  260.0  R  300.0  35.0  456789  3.0  5:0.0 


WEAPON^STATOSjQOERY 

ffEAPON_STATUS_QUERy  <weapon  number>  <source  id>  <timestamp> 

Description  •  This  event  queries  status  of  a  selected  weapon  icon. 

Examples*  mAPON_STAWSj;ii!ERy  30o  200  5: 0.0 


Miscellaneous  Object  Events 

OBJECT_ACTIVATE 

OBJECT_ACTIVATE  <object  number>  <object  description>  \ 

<UTM  coordinates>  <elevation>  <timestamp> 

Description  •  New  miscellaneous  object  icon  activated  for  visual  simulation. 
Example*  0BJECT_ACTIVATE  250  bunding  1234567890  5:0.0 
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OBJECT  DEACTIVATE 


OBJECTJDEACTIVATE  <object  number>  <€imestamp> 

Description  -  Miscellaneous  object  icon  deactivated  from  visual  simulation. 

Example-  object_deactivate  250  5:0.o 

OB JECT_COLLI SON 

OBJECT_COLLISION  <object  number>  <description  result>\ 

<UTM  coordinates>  <elevation>  <timestamp> 

Description  -This  event  is  a  transient  event  indicating  miscellanious  object  icon  collision  with 
another  icon. 

Example  -  0BJECT_C0LLISI0N  250  destroyed  79A-DN-1234567890  0,0  5:0.0 


OBJECT_EXPLOSION 

OBJECT_EXPLOSION  <object  number>  <explosion  description>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  direction>  \ 

<bound  area  Y  direction>  <UTM  coordinates>  \ 
<elevation>  <timestamp> 

Description  -  This  event  is  a  transient  event  of  a  miscellaneous  object  icon  explosion. 

Attributes  required  are  explosion  type  and  bounding  area  for  explosion. 

Example-  0BJECT_EXPL0SI0N  250  largescale  10.0  10.0  10.0  12345678  0.0  5:0.0 


0BJECT_FIAMIN6 

OBJECT_FLAMING  <object  number>  <description  of  fire>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  direction>  \ 

<bound  area  Y  direction>  <offset  X  direction>  \ 
<offset  Y  direction>  <offset  Z  direction>  \ 
<UTM  coordinates>  <elevation>  <timestamp> 
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Description  -  This  event  is  a  transient  event  of  a  miscellaneous  object  icon  in  flames. 
Attributes  required  are  flame  type,  bounding  area  of  the  smoke,  and  the  object  offset  of  the 
flames. 

Example*  OBJECT_FLmim  250  largescale  10.0  10.0  10.0  0.0  0.0  0.0\ 
1234567890  0.0  5:0.0 

OBJECT__SMOKING 

OBJECT_StiOKING  <object  number>  <description  of  smoke>  \ 

<bound  area  X  direction>  \ 

<bound  area  Y  direct ion>  \ 

<bound  area  Y  direction>  <offset  X  directioO  \ 
<offset  Y  direction>  <offset  z  direction>  \ 

<UTM  coordinates>  <elevation>  <timestamp> 

Description  *  This  event  is  a  transient  event  of  a  miscellaneous  object  icon  emitting  smoke. 
Attributes  required  are  smoke  type,  bounding  area  of  the  smoke,  and  the  object  offset  of  the 
smoke. 

Example-  OBJECT_SMOKim  250  mediumsmoke  10.0  10.0  10.0  0.0  0.0  0.0\ 
1234567890  0.0  5:0.0 

OBJECTJJPDATE 

OBJECT_UPDATE  Kobject  number>  <object  status>  \ 

<UTM  coordinates>  <elevation>  <timestamp> 

Description  -  This  event  queries  status  of  a  selected  miscellaneous  object  icon. 

Examples-  0BJECT_UPDATE  250  active  1234567890  0.0  5:0.0 

OBJlCT_STATUSjQUERY 

OBJECT_STATUSjQUBRY  <object  number>  <time3tamp> 

Description  -  This  event  queries  status  of  a  selected  miscellenous  object  icon. 

Example-  object_status_qvery  250  5:0. 0 
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Environment  Events 


ENVIRONMENT_ACTIVATE 

BtfVXRONMENT_ACTIVATE  <environment  object  nvmber>  <type  description>  \ 

<heading>  <velocity>  <UTM  coordinates>  \ 
<elevation>  <timestamp> 

Description  •  New  environment  effect  icon  is  activated  for  visual  simulation. 

Example-  ENVIROmBNT_ACTIVATE  400  cloud  345.0  5.0  1234567890  5:0.0 

ENVIROKMENT__DEACTIVA^i'E 

EbJVIRONMENT_DEACTIVATE  <envi ronmeot  object  nurnber>  <timestamp> 

Description  -  Environment  effect  icon  of  vehicle  number  is  deactivated  from  visual 
simulation. 

Example-  EmiROPMEPT_DEACTIVATE  400  5:0.0 

Sfiriptflptions 

SCRIPT_ABORT 

SCRIPT_ABORT 

Description  -  Normal  termination  of  NPSNET-OASIS  requires  all  statements  in  the  input 
script  file  to  be  processed.  However,  the  animator  has  the  option  to  terminate  the  script  by 
inserting  SCRIPT_ABORT.  This  script  directive  has  no  arguments.  When  encountered,  all 
script  files  are  closed,  and  a  script  result  of  END_OF_SCRIPT  is  returned  to  the  system. 
Example-  script_abort 

SCRIPT_CALL 

SCRIPT_CALL  <£ilename  for  script  call> 

Description  -  The  directive  SCRIPT_CALL  is  a  subscript  call,  similar  to  a  procedure  call 
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in  a  high-level  programming  language.  The  argument  for  this  directive  is  a  string 
containing  the  script  file  name.  The  calling  script  file  is  suspended  during  processing  of  the 
subscript.  Only  one  script  is  processed  at  any  given  time.  Script  file  control  returns  to  the 
caller  on  subscript’s  end  of  file.  This  directive  supports  modular  scripting  in  NPSNET- 
OASIS. 

Example-  script_call  script-i.mi 


SCRIPTjCHAIN 

SCRIPT_^CHAIN  <filename  for  script  chaining> 

Description  -  Linking  of  one  input  script  file  to  another  requires  the  script  directive 
SCRIPT_CHAIN.  The  required  argument  is  a  sfe  'ig  containing  the  ^ript  file  name.  After 
the  chained  script  file  is  successfully  opened,  the  other  script  file  is  closed.  This  directive 
is  useful  for  combining  small  script  files  into  one  large  script. 

Example-  scriptj:haxh  script-i.mi 

SCRIPT^REPEAT 

SCRIPT_REPEAT  <iterations>  <object  nutnber  acijustment>  \ 

<time  adjustment> 

Similar  to  a  counter-con&olled  loop,  the  script  directive  SCRIPT-REPEAT  allows  scripts 
to  be  processed  repeatedly.  There  are  three  arguments  for  SCRIPT_REPEAT  -  iterations, 
object  number  adjustment,  and  timestamp  adjustment.  Iterations  are  values  for  the  number 
of  times  repeadng  the  same  script.  Object  number  adjustment  is  the  increment/decrement 
value  for  all  3D  icon  identification  numbers.  Similar  to  the  script  option 
SCRIPT_TIME_ADJUSTMENT,  timestamp  adjustment  is  the  increment/decrement  of 
timestamps  for  each  repeated  script  event.  All  script  events  in  script  chains  and  script  calls 
are  affected  by  SCRIPT_REPEAT.  This  directive  is  useful  for  repeating  the  entire  script, 
or  repeating  a  short  series  of  script  events. 
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Example  -  sci?ipr_R£PEAr  lO  i  2:0,o 

SCRIPT^LOCATION 

SCRIPT_LOCATION  <new  default  UTM  gridzone  and/or  MGRS> 

Description  -  Upon  initialization,  the  NPSNET-OASIS  system  assigns  the  default  UTM  gridzone 
and  MGRS  with  strings  “lOS”  and  “DN”  respectfully.  Defaults  will  be  assigned  when  an  UTM 
gridzone  and/or  MGRS  are  not  included  in  the  event  position.  Replacing  one  or  both  system 
defaults,  requires  SCRIPT_LOCATION  to  be  used  in  the  script. 

Examples  -  scriptjlocation  79a-dn 

SCRIPT_LOCATION  79A 
SCRIPT_LOCATION  DN 

SCRIPTJTIMESTAMP 

$CRIPT_TIMESTAMP  <time  reference  for  script  timestamps> 

D^cription  -  The  default  time  reference  for  NPSNET-OASIS  system  is  “relative”.  The  other 
option  is  “absolute”.  SCRIPTJTIMESTAMP,  with  the  selected  string  as  argument,  is  used  to 
change  time  reference  in  script  processing.  Relative  time  reference  is  for  all  timestamp  adjustments 
based  on  input  script  start  time.  Absolute  time  reference  is  for  all  timestamp  adjustments  based  on 
system  stan  time. 

Examples  -  SCRIPT_TIMESTAMP  relative 
SCRIPTJTIMESTAMP  absolute 

SGRIPT_TIME_FACTOR 

SCRIPT_TItm_FACTOR  <time  factor  value> 

Descriptitm  -  Another  option  for  adjusting  timestamp,  is  the  use  of  SCRIPTjnME_FACTOR. 
With  a  floating-type  numeric  argument,  SCRIPT_TINffijFACTOR,  provides  the  time  factor 
percentage  fcn-each  event  timestamp.  This  option  is  useful  for  incrementing  or  decrementing  speed 
of  script  processing. 
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Example  -  scRXPr_riMB_FAC2’0i?  0.5 
SCRIPT_TIME_ADJUSTMENT 

SCRIP  r_  TIME_ADJUS  TMENT  <timesta‘^.,p> 

Description  -  Changing  event  timestamps  throughout  the  script  requires 
SCRIPT_TIME_ADJUSTMENT  to  be  inserted  prior  to  selected  statements.  An  argument  in 
timestamp  format,  is  used  for  adding  to  event  timestamps.  To  stop  timestamp  adjustments,  requires 
another  SCRIPT_TIME_ADJUSTMENT  and  an  argument  of  zero. 

Example  -  SCRtPT_TIME__ADJUSTMENT  10:0.5 

SCRIPT_DEIAY 

SCRIPT^DELAY  <timestamp>  <type  of  script  delay> 

Description  -  There  are  two  arguments  required  for  SCRIPT_DELAY  -  timestamp  and  delay  type. 
Delay  type  is  either  “absolute”  or  “relative”.  In  absolute,  the  current  script  is  suspended  until  the 
time  specified  by  the  timestamp.  In  relative,  the  current  script  is  suspended  for  the  time  duration 
specified  by  the  timestamp. 

Examples  -  SCRIPT_DELAY  10:0.0  relative 
SCRIPT_DELAY  25:24.0  absolute 

SCRIPT_FILEJWRITE 

SCRIPT_FILE_WRITE  <script  line> 

Description  -  Script  objects  recorded  to  an  output  script  file  include  script  events  and  script 
comments.  There  sse  no  script  options  or  blank  lines.  SCRIPT_FI1£_WRITE  provides  animators 
the  capability  to  include  any  type  of  script  statements  in  a  recorded  script,  if  there  is  no  output  ^pt 
file,  then  an  error  n^ssage  is  displayed. 

Example  -  SCRIPT^FILEJ/RITE  SCRIPT_HESSAGE  end  of  script 
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SCRIPS?  MESSAGE 

rnmm 

SCRIPT_MESSAGE  <message> 

Description  -  While  developing  software,  programmers  include  statements  in  their  source  code  for 
trying  and  debugging.  In  HPSNET-OASIS,  animators  have  the  same  capability  by  allowing  script 
messages  to  be  displayed  on  a  standard  output  device.  Messages  can  include  any  text  desired  by 
the  animator.  One  suggestion  is  to  use  script  messages  prior  to  selected  script  events.  Messages 
with  information  on  upcoming  events  provide  advanced  warning  of  what  to  expect  in  visual 
simulation. 

Example-  SCRIPT_MESSAGE  End  of  script 
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Script  Results 


SCRIPT__ERROR 

SCRIPT_ERROR  is  returned  from  NPSNET-OASIS  when  an  input/output  file  error  occurred  or  a 
script  smtement  is  invalid.  File  errors  occur  if  unable  to  open  ot  close  a  file.  Invalid  ^pt . 
statements  include  invalid  syntax  for  script  comments,  invalid  procedural  operators,  invalid 
arguments  for  a  proc^ural  operator,  and  invalid  formats  for  arguments. 

ENDjOP__SCRIPT 

On  end  of  script,  which  includes  processing  of  all  input  script  files,  a  result  of  END_OF_SCRIPT 
is  returned. 

SCRIPT_INJ)EIAY 

SCRIPT_IN_DELAY  is  returned  when  processing  of  script  files  sue  suspended. 

SCRIPT_VALID 

For  a  result  of  SCRIPT_VAL1D,  script  statements  arc  of  valid  syntax. 

NO_SCRIPT_EVENr 

An  option  for  classes  built  on  top  of  NPSNET-OASIS,  NO_SCRIPT_EVENT  is  returned  when’ 
script  processing  is  suspended  or  a  script  event  is  not  ready  for  return.  Used  in  the  NPSNET- 
OASIS  network  interface,  NO_SCRn*T_EVENT  is  returned  when  the  script  event  is  not  re^y  for 
multicast. 
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ScriptEcrojis 

NPSNET‘OASIS  can  only  have  one  main  input  script  file  assigned.  If  another  is  assigned  then  the 
following  is  displayed: 

SCRIPT  ERROR:  Only  one  main  script  permitted  to  be  open. 

The  following  message  is  displayed  if  the  mtun  script  file  does  nm  exist.  Possible  can 

include  file  does  not  exist,  or  some  characters  of  the  file  name  are  of  upper  case. 

SCRIPT  ERROR:  Unable  to  open  main  script  file  'filename'. 

When  NPSNET-OASIS  is  unable  to  close  a  script  rile  a  message  is  displayed. 

SCRIPT  ERROR:  Unable  to  close  'filename'. 

There  are  ems’  messages  for  invalid  file  q)ens  far  script  chaining  or  script  call.  In  a^titm,  aimter 
line  is  displayed  infcnming  the  line  number  and  file  name  of  the  script  flle  containing  the  soipt 
qnion.  Messages  are  as  follows: 

SCRIPT  ERROR:  Unable  to  open  script  'filename'  for  chaining. 
SCRIPT  ERROR:  Unable  to  open  script  'filename'  for  script  call. 

Script  events  to  be  rec(»ded  require  an  output  script  file.  If  the  file  does  not  exi^  then  tl^ 
ftdlowing  error  message  is  displayed: 

SCRIPT  ERROR:  No  output  file  opened  for  script  generation. 

For  recording  ^pts,  the  following  message  is  displayed  if  a  procedural  operator  of  a  script  event 
does  ncH  exist. 

SCRIPT  ERROR:  Invalid  event  for  script  generation. 
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If  the  script  statement  is  not  a  script  comment  or  a  valid  script  procedural  operator,  then  the 
following  message  is  displayed: 

SCRIPT  ERROR:  Invalid  OASIS  Procedural  Operator. 

For  a  valid  script  comment,  the  start  symbol  7*'  <ind  the  termination  symbol  ’*/’  must  exist.  In 
»idition,  no  nesting  of  comments  are  permitted.  When  the  termination  symbol  is  encountered  by 
the  script  processor,  the  rest  of  the  script  line  is  checked  for  invalid  characters.  Messages  are  as 
follows: 

SCRIPT  ERROR:  Invalid  characters  after  script  comment  end  symbol. 
SCRIPT  ERROR:  Encountered  another  script  comment  beginning. 
SCRIPT  ERROR:  Script  comment  with  no  end  symbol. 


When  script  statements  contain  valid  procedural  operator,  chances  are  that  required  arguments  arc 
missing,  some  arguments  are  of  invalid  format,  or  too  many  arguments.  If  this  should  happen,  then 
an  error  message  is  displayed  followed  by  another  line  containing  line  number  and  name  of  input 
script  file.  There  is  a  separate  error  message  for  each  procedural  operator.  Messages  are  as 
follows: 


SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  E^OR: 
SCRIPT  ERROR: 


Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Inva'id  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 
Invalid  parameters 


for  environment_activate. 
for  environment_deactivate. 
for  vehicle_activate . 
for  vehicle_deactlvate. 
for  vehicle_modification. 
for  vehicle _pitch. 
for  vehicle_roll . 
for  vehicle jposition. 
for  vehicle_heading . 
for  vehicle_speed. 
for  vehicle_trail . 
for  vehicle_collision. 
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SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 
SCRIPT  ERROR: 


Invalid  parameters  for  vehicle_explosion. 
Invalid  parameters  for  vehicle_f laming. 

Invalid  parameters  for  vehicle_smoking. 

Invalid  parameters  for  vehicle_destroyed. 
Invalid  parameters  for  vebicle_fuel . 

Invalid  parameters  for  vehicle_ammunition. 
Invalid  parameters  for  vehicle_update. 

Invalid  parameters  for  vehicle_status_query. 
Invalid  parameters  for  object_activate. 

Invalid  parameters  for  object_deactivate. 
Invalid  parameters  for  object_collision. 
Invalid  parameters  for  object_explosion. 
Invalid  parameters  for  object_f laming. 

Invalid  parameters  for  object_smoking. 

Invalid  parameters  for  objectjapdate . 

Invalid  parameters  for  object_status_guery. 
Invalid  parameters  for  script_time_f actor. 
Invalid  parameters  for  script_time_adjustment. 
Invalid  parameters  for  script_delay. 

Invalid  parameters  for  script_abort . 

Invalid  parameters  for  scriptjcall . 

Invalid  parameters  for  script_chain. 

Invalid  parameters  for  script_repeat . 

Invalid  parameters  for  script_timestamp. 
Invalid  parameters  for  script_location. 
Invalid  parameters  for  weapon_launch. 

Invalid  parameters  for  weapon_impact . 

Invalid  parameters  for  weapon_explosion , 
Invalid  parameters  for  weapon_update . 

Invalid  parameters  for  weapon_status_query . 
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APPENDIX  B 

NPSNET-OASIS  Sample  Scripts 


/★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★A************************************ 

File:  script. ml 

Description:  Sample  script  of  two  M-1  tanks  in  motion 

Host  Id  Number:  501 

Simulator:  NPSNET  on  IRIS  VGX  Workstation 

Author:  Phillip  West 

**********************************★*********************************/ 

/*  Assign  timestamp  reference  relative  to  start  time  of  input  script  */ 
SCRIPT_TIMESTAMP  relative 

/*  Assign  default  UTM  gridzone  and  MGRS  */ 

SCR1PT_L0CATI0N  IIS-DN 

/*  Assign  time  factor  of  50  percent  for  all  timestamps  */ 

SCRIP T_TIME_FACTOR  0 . 5 

/*  Assign  time  adjustment  value  of  10  seconds  for  all  timestamps  */ 
SCRIPT_TIME_ADJUSTMENT  10.0 

/*  Activate  clouds  with  velocity  5.0  km/h,  heading  270.0  west  */ 

ENVIRONMENT_ACTIVATE  5010500  Cloud  270.0  5.0  34536783  1000.0  30.0 

/*  Activate  two  M-1  tanks  */ 

VEHICLE_ACT1VATE  5010001  Ml  090.0  40.0  344955  0.0  40.0 

VEHICLE_ACTIVATE  5010002  Ml  090.0  40.0  345958  0.0  45.0 

/*  Change  headings  of  M-1  tanks  */ 

VEHICLE_HEADING  5010001  135.0  344801  0.0  2:0.0 

VEHICLE_HEADING  5010002  120.0  344803  0.0  2:5.0 

/*  Change  velocities  of  M-1  tanks  */ 

VEHICLE_SPEED  5010001  5.0  344670  0.0  6:0.0 

VEHICLE_SPEED  5010001  5.0  344677  0.0  7:25.0 

/*  M-1  tanks  passing  by  a  building  */ 

OBJECT_ACTIVATE  5010004  Building  344701  0  8:10.0 

OBJECT_DEACTIVATE  5010004  9:40.0 

/*  Script  message  for  advance  warning  of  upcoming  script  events  */ 
SCRIPT_MESSAGE  Activating  column  of  jeeps 

/*  Script  call  for  column  of  jeeps  */ 

SCRIPT_CALL  script -2 . jeeps 
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/*  Continue  script  with  next  script  file  */ 
SCRIPT_CHAIN  script-1. ml 


File: 

Description: 
Host  Id  Number: 
Simulator; 
Author : 


script-1. ml 

Sample  script  of  two  M-1  tanks  in  motion 
501 

NPSNET  on  IRIS  VGX  Workstation 
Phillip  West 


/*  M-1  tanks  passing  by  a  palm  tree  */ 

0BJECT_ACT1VATE  5010003  PalmTree  345700  0  22:0,0 

OBJECTJDEACTIVATE  5010003  22:35.0 

/*  Change  velocities  of  M-1  tanks  */ 

VEHICLE_SPEED  5010001  5.0  345670  0.0  26:0.0 

VEHICLE_SPEED  5010001  5.0  345677  0,0  27:25.0 

/*  Deactivate  M  1  tanks  */ 

VEHICLE_DEACTIVATE  5010001  29:45.0 

VEHICLE_DEACTIVATE  5010002  29:50.0 

/*  Deactivate  column  of  jeeps  */ 

SCRIPT_CALL  script-3. jeeps 

/*  Continue  script  with  another  scenario  */ 

SCRIPT_CALL  script-4. fl4 

/*  Deactivate  clouds  */ 

ENVIRONMBNT_DEACTIVATE  5010500  45:0.0 

/*  Script  delay  for  duration  of  2  minutes  prior  to  termination  */ 
SCRIPT_DEIiAY  2:0.0  absolute 

/*  Write  to  output  script  file  message  for  next  script  processing  */ 
SCRIPT_FILE_WRITE  SCRIPT_MESSAGE  End  of  Script 

/*  script  message  for  end  of  script  */ 

SCRIPT_MESSAGE  ***  DEMO  COMPLETE  *** 

/*  Terminate  script  */ 

SCRIPT  ABORT 
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^icicit'k’k’k'k'kiticicic'k'k'k'k'k'k'k'k'kic'k’k'k'k'k'k'k'k’kit'k'k'k'kie'k’kic’k'k’k'k'kicic’k'k'k'k'k'k'k'k'k'k'kie'k'k'k'k'k’k'k'k 

File:  script-2 . jeeps 

Description:  Sample  script  of  activating  multiple  jeeps 

Host  Id  Number:  501 

Simulator:  NPSNET  on  IRIS  VGX  Workstation 

Author:  Phillip  West 


/*  Activate  jeep  vehicle  */ 

VEHICLB_ACTIVATE  5010010  Jeep  090.0  40.0  345678  0.0  10:0.0 

/*  Repeat  script  for  10  iterations  with  total  11  separate  vehicles  */ 
SCRIPT  REPEAT  10  1  1:0.0 


File: 

Description : 

Host  Id  Number; 
Simulator: 

Author: 

■kitifififfkititifififk-k-kit'kit'kififk-kit 


script-3. jeeps 

Sample  script  of  deactivating  multiple  jeeps 
501 

NPSNET  on  IRIS  VGX  Workstation 
Phillip  West 

********<»:A****1lr*lt*********************iAr***** 


/ 


/*  Deactivate  jeep  vehicle  */ 

VEHICLE_DEACTIVATE  5010010  29:0.0 

/*  Repeat  script  for  10  iterations  with  total  11  deactivate  jeeps  */ 
SCRIPT  REPEAT  10  1  1.0 
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/*******************i^r*****************itit****************^***********  ’ 

File:  script-4. fl4 

Description:  Sample  of  a  script  of  a  flying  aircraft 

Host  Id  Number:  501 

Simulator:  NPSNET  on  IRIS  VGX  Workstation 

Author:  Phillip  West 

icic'kit*'kifk'k*'k‘k'kicir*ic-k*1fk-k**1cic'kifk1t*iiic'k'k'kic'k****ic*'kic*ifk'k**i!*'kifk****ic't.ic***ii/ 

/*  Activate  F-14  aircraft  in  flight  status  */ 

VEHICLE_ACTIVATE  5010110  F14  090.0  540.0  345678  1000.0  30:0.0 

/*  Aircraft  roll  to  port  10  degrees  */ 

VEHICLE_ROLI,  5010110  10.0  port  344677  1000.0  31:10.0 

/*  Aircraft  level  roll  to  0  degrees  */ 

VEHICLE_ROLL  5010110  0.0  none  344676  996.7  34:56.5 

/*  Sea  sparrow  launch  from  F-14  */ 

WEAPON_LAUNCH  5010210  5010110  seasparrow  240.0  R  400.0  -lO 

344675  995.6  36:0.0 

/*  Weapon  impact  on  surface  */ 

WEAPON  IMPACT  5010210  5010110  342670  0.0  38:43.5 


/*  Weapon  exploded  on  surface  */ 


WEAPON  EXPLOSION 


5010210  5010110  342670  0.0  39:0.0 


/*  Deactivate  F-14  */ 
VEHICLE  DEACTIVATE 


5010110  43:0.0 


.0\ 
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APPENDIX  C 


/  y- 

Class  Definition  of  ScriptProcessor 

// 

Classtype: 

ScriptProcessor 

// 

Derived  from: 

VehicleProcessor,  WeaponProcessor, 

// 

MiscObjectProcessor,  EnvironmentProcessor, 

// 

ScriptOptionProcessor 

// 

Base  for: 

OasisSystem 

// 

Remarks : 

This  class  provides  the  mechanism  to  read  script 

// 

files  and  process  script  events  for  valid  script 

// 

//= 

objects  and  comments. 

class  ScriptProcessor  :  private  VehicleProcessor, 

private  WeaponProcessor, 
private  MiscObjectProcessor, 
private  EnvironmentProcessor, 
private  ScriptOptionProcessor  { 

public: 

ScriptProcessor 0 ;  //  Constructor 

-ScriptProcessor 0 ;  //  Destructor 

//  Member  functions  for  ScriptProcessor 
long  ReadScriptObject (ScriptOb ject&  Script); 

//  Reads  next  script  object  from  input  script  file  and 
//  returns  null  if  error  occurs. 

SourceScriptFile*  GetScriptFileO / 

//  Returns  reference  pointer  of  current  input  script  file, 
void  SetScriptFile (SourceScriptFile*  Scriptfile) ; 

//  Assigns  current  script  file  for  script  processing, 
void  SetUtmScriptDefaults (char  *Gridzone,  char  *Mgrs) ; 

//  Assigns  default  gridzones  and  mgrs  for  event  positions. 
ScriptProcessor*  Instance ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

protected: 

SourceScriptFile*  CurrentScriptFile; 

//  Current  input  script  file. 

private: 

long  SetupScriptLine (char  *Line) ; 

//  Removes  excess  blank  spaces  and  converts  uppercase 
//  characters  to  lower  case.  Returns  $CRIPT_COMMBNT 
//  if  script  line  is  the  beginning  of  a  comment  block, 
long  ScanForBlankLines (char  *Line) ; 

//  Returns  null  for  non-blank  lines. 
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long  DetermineEvent (ScriptObjectfi  Script,  char*  Line); 

//  Determines  procedural  operator  for  script  object,  and 
//  calls  group  processor  for  procedural  operator.  Returns 
//  null  if  script  error  occurs. 

);  //  end  class  ScriptProcessor 
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APPENDIX  D 

Class  Definition  of  ScriptGenerator 

//  ciasstype:  ScriptGenerator 

//  Derived  from:  OasisSystemObject 
//  Base  for:  OasisSystem 

//  Remarks:  This  class  provides  the  mechanism  in  writing  script 

//  files. 

class  ScriptGenerator  :  public  OasisSystemObject  { 
public: 

ScriptGenerator 0 ;  //  Constructor, 

-ScriptGeneratcr 0 ;  //  Destructor. 

//  Member  functions  for  ScriptGenerator 
long  OpenOutputFile (char  *Name) ; 

//  Opens  output  script  file  and  returns  TRUE  for  successful 
//  file  open. 

long  WriteScriptOb ject (ScriptObjectS  Script); 

//  Writes  script  object  to  script  file  and  returns  TRUE  for 
//  successful  file  write, 
long  WriteScriptLine (char  ‘Line) ; 

//  Writes  script  object  to  script  file  and  returns  TRUE  for 
//  successful  file  write, 
long  CloseOutputFile ( ) ; 

//  Closes  output  script  file  and  returns  result  of  file 
//  close. 

ScriptGenerator*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  ‘ClassName () ; 

//  Returns  class  identification  string. 

protected: 

DestinationScriptFile  OutFile; 

//  Current  destination  script  file. 

private: 

void  WriteVehicleEvent (VehicleEvent&  Vehicle); 

//  Writes  script  object  of  vehicle  event  to  output  script 
//  file. 

void  WriteWeaponEvent (WeaponEventfi  Weapon) ; 

//  Writes  script  object  of  weapon  event  to  output  script 
//  file. 

void  WriteMiscObjectEvent (MiscObjectEventS  MiscObject); 

//  Writes  script  object  of  miscellaneous  object  event  to 
//  output  script  file. 

void  WriteEnvironmentEvent (EnvironmentEvent&  Environment); 

//  Writes  script  object  of  environment  event  to  output 
//  script  file. 
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void  WriteComment (ScriptCommentfi  Comment); 

//  Writes  script  comment  bloclc  to  output  script  file. 
) ;  //  end  class  ScriptGenerator 
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APPENDIX  E 

Class  Definition  of  TimeKeeper 


//============*== 

//  Classtype: 

//  Derived  from; 
//  Base  for: 

//  Remarks: 

// 

// 

//=============== 


TimeKeeper 

OasisSystemOb ject 
OasisSystem 

This  class  provides  the  functions  to  keep  track  of 
time,  and  convert  to  and  from  script  object 
timestamps . 


class  TimeKeeper  :  public  OasisSystemObject  { 
public : 

TimeKeeper 0 ;  //  Constructor 

TimeKeeper (long  Reference);  //  Constructor 

~TimeKeeper {) ;  //  Destructor 

//  Member  functions  for  TimeKeeper 
long  GetClockReference ( ) ; 

//  Returns  clock  reference  of  timekeeper, 
void  SetClockReference (long  Reference); 

//  Assigns  clock  reference  of  timekeeper, 
void  StartSystemTime ( ) ; 

//  Saves  time  of  system  start, 
void  StartInputScriptTime ( ) ; 

//  Saves  time  of  start  for  input  script, 
void  StartOutputScriptTime  0 ; 

//  Saves  time  of  start  for  output  script, 
void  SetSystemStartTime (long  Seconds,  long  Microseconds) ; 

//  Assigns  system  start  time. 

void  SetInputScriptStartTirae (long  Seconds,  long  Microseconds); 

//  Assigns  start  time  for  input  script  file, 
void  SetOutputScriptStartTime (long  Seconds,  long  Microseconds) ; 

//  Assigns  start  time  for  output  script  file, 
void  CurrentSystemTimestamp(ScriptEvent&  Event); 

/ /  Assigns  timestamp  of  script  object  to  current  system 
//  time  (Absolute  or  Relative). 

void  ScriptToSystemTimestamp(ScriptEvent5  Event, long  Reference); 
//  Modifys  timestamp  of  script  object  to  reflect  time 
//  reference  to  system  time. 

void  SystemToScriptTimestamp (ScriptEventS  Event, long  Reference); 
//  Assigns  timestamp  of  script  object  to  reflect  reference 
//  to  start  of  system  time  or  start  of  input  script  file, 
void  SetScriptDelay (ScriptEvent&  Delay,  long  Reference); 

//  Assigns  time  to  disable  script  delay  based  on  type  of 
//  delay.  Absolute  delay  is  based  on  system  start  time. 

II  Relative  is  based  on  duration  of  delay, 
long  ActiveScriptDelay ( ) ; 

//  Returns  TRUE  if  script  delay  is  still  active. 
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TimeKeeper*  Instance {); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private: 

long  ClockReference; 

//  Time  reference  for  time  keeper. 

TimeValue  System_Starttime; 

//  Start  time  of  system. 

TimeValue  InputScript_Starttime; 

//  Start  time  of  input  script. 

TimeValue  OutputScript_Starttime; 

//  Start  time  of  output  script. 

TimeValue  Bnd_Of_DelayTime; 

//  Time  to  release  script  delay, 
void  ConvertToTinestamp (TimeValue  *time,  ScriptEventS  Event); 
//  Converts  system  time  to  script  object  timestamp. 

};  //  end  class  TimeKeeper 
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APPENDIX  F 

Class  Definition  of  OasisSystem 


//  Classtype: 

//  Derived  from: 
//  Base  for: 

//  Remarks: 

// 

// 

/  /sssssasssassssssssssB 


OasisSystem 

TimeKeeper,  ScriptProcessor,  ScriptGenerator 
OasisScriptSorter,  OasisScriptPreprocessor 
This  class  provides  the  mechanism  for  reading  and 
writing  script  files.  All  script  options  are 
processed  internally. 


class  OasisSystem  :  private  TimeKeeper, 

private  ScriptProcessor, 
private  ScriptGenerator  ( 

public: 

OasisSystemO ;  //  constructor 

OasisSystem (long  ClockReference) ; //  constructor  (use  SYSTEM_CLOCK 

//  for  reference  in  system  time 
//  access,  or  use  USER_CLOCK  for 
//  time  provide  by  the  user. 

~OasisSystem() ;  //  destructor 

//  Member  functions  for  OasisSystem 
long  OpenInputScriptFile (char  *Name) ; 

//  Opens  script  file  for  input.  Returns  TRUE  for  successful 
//  file  open. 

long  OpenOutputScriptFile (char  *Name) ; 

//  Opens  script  file  for  output.  Returns  TRUE  for 
//  successful  file  open, 
long  GetScriptOb ject (ScriptOb jects  Script); 

//  Requires  ScriptOb ject  as  argument  for  script  event  I/O. 
//  The  script  object  is  returned  with  result  of  either  - 
//  SCRIPT_ERROR,  SCRIPT_VALID,  END_0F_SCR1PT, 

//  SCRIPT_IN_DELAY,  or  NO_SCRIPT_EVENT. 
long  PutScriptOb ject (ScriptOb jects  Script); 

//  Writes  script  object  to  output  script  file  and  returns 
//  TRUE  for  successful  file  write, 
long  CloseInputScriptFile {) ; 

//  Closes  input  script  file  and  returns  result  of  TRUE  for 
//  successful  file  close, 
long  CloseOutputScriptFile { ) ; 

//  Closes  input  script  file  and  returns  result  of  TRUE  for 
//  successful  file  close, 
double  GetTimeFactor 0 ; 

//  Returns  time  factor  for  computing  timestan^s  for  all 
//  script  objects. 

void  SetTimeFactor (double  Factor) ; 

//  Assigns  time  factor  for  computing  timestamps  for  all 
//  script  objects. 
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void  SetSystemStartTimedong  Seconds,  long  Microseconds) ; 

//  Only  used  in  USER_CLOCK  time  reference,  the  system 
//  starttime  is  altered  to  match  total  seconds  and 
/ /  microseconds .  Start  times  for  input  and  output  script 
//  files  will  be  the  same  for  system  start  time, 
void  DisableScriptMessagesAndDelays  O ; 

//  Sets  flag  for  no  script  messages  to  be  displayed  and 
//no  script  delays  to  be  activated 
OasisSystera*  Instance  ( ) ; 

//  returns  reference  pointer  of  instance, 
virtual  char  *ClassName ( ) ; 

//  returns  class  identification  string. 

protected: 

SourceScriptFile  *CurrentInputFile; 

//  Reference  to  current  input  scriptfile 

private: 

long  EndOflnputScript; 

//  Boolean  flag  for  end  of  script  file, 
long  DelayActive; 

//  Boolean  flag  for  active  script  delay, 
long  MessagesAndOelays; 

//  Initially  TRUE  allowing  script  messages  and  delays 
double  TimeAdjustment; 

//  Amount  of  time  to  adjust  script  timestamps, 
double  TimeFactor; 

//  Time  factor  for  each  computed  timestamp, 
long  TimeReference; 

//  Time  reference  for  determining  type  of  timestamp  for 
//  script  object.  ABSOLUTE_TIME  for  assigning  timestamps 
//  relative  to  system  start  time.  RELATIVE_TIME  for 
//  assigning  timestamps  relative  to  input  script  start 
//  time. 

void  ModifyScriptObject (ScriptEventfi  Event); 

//  Modifys  script  object  in  computing  timestamps  according 
//  to  time  reference  time  adjustment,  and  time  factor, 
long  ProcessScriptCptionCScriptOpticna  Option); 

//  Process  script  option  for  OASIS.  Returns  either 
//  SCR1PT_VALID  or  END_OF_SCRIPT. 
long  DelayScript (ScriptOptionfc  Option) ; 

//  Assigns  script  delay  based  on  type  of  reference  in  tim« 
//  delay.  If  absolute,  delay  is  aborted  when  system  time 
//  matches  timse  of  delay.  If  relative,  time  of  delay  is 
//  added  to  time  of  receiving  script  object  for  reference. 
long  ChainScript (ScriptOptionfc  Option) ; 

//  Closes  current  script  file  and  opens  another.  Returns 
//  null  if  error  occurs, 
long  CallScript (ScriptOptionfi  Option); 

//  Calls  script  file  as  a  subroutine  and  returns  back  to 
//  calling  script  file.  Returns  null  if  error  occurs 
//  during  file  open. 


60 


long  RepeatScript (ScriptOptionfi  Option); 

//  Repeats  current  script  file  for  number  of  iterations. 
};  //  end  class  OasisSystem 
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APPENDIX  G 

Class  Deflnition  of  OasisScriptSorter 


//= 

// 

Classtype: 

OasisScriptSorter 

// 

Derived  from; 

OasisSystem 

// 

Base  for: 

none 

// 

// 

// 

Remarks: 

This  class  provides  the  mechanism  to  sort  script 
objects  of  source  script  files  and  writes  back  to  a 
destination  script  file.  The  qsort  function  of 

// 

//= 

ANSI  C  is  used  for  sorting. 

# 

Glass  OasisScriptSorter  :  private  OasisSystem  { 
public; 

OasisScriptSorter <) ;  //  Constructor 

•“OasisScriptSorter  0  ;  //  Destructor 

II  Member  functions  for  OasisScriptSorter 
long  PerformSort (char  *Source,  char  *Destination) ; 

//  Performs  sort  of  source  script  file  and  generates  sorted 
//  script  to  a  destination  script  file.  Source  and 
//  Destination  can  be  the  same  file  name. 

OasisScriptSorter*  Instance ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private: 

long  ReadScriptFile (char  * Source ) ; 

//  Reads  script  file  into  sort  array  and  returns  TRUE  for 
//  valid  script  file  or  FALSE  for  invalid  script  file, 
long  WriteScriptFile (char  *Destination) ; 

//  Writes  script  objects  from  sort  array  to  destination 
//  script  file.  Returns  TRUE  if  valid  script  write, 
long  NumberOf Entries; 

//  Returns  number  of  script  objects  in  sort  array. 
ScriptSource  *Script; 

//  Array  for  sorting  script  objects, 
void  CreateSort Array  0 ; 

//  Creates  sorting  array, 
void  DestroySortArray 0 ; 

//  Destroys  sorting  array, 
double  GetTimestamp (ScriptObjectfi  Source); 

//  Returns  timestamp  in  total  seconds  and  microseconds  from 
//  script  object, 
double  PreviousTimestamp; 

//  Timestamp  of  previous  script  object, 
long  PreviousObjectWasAComment; 

//  Boolean  flag  for  previous  script  object. 

);  //  end  OasisScriptSorter 
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APPENDIX  H 

Class  Definition  of  OasisScriptPreprocessor 


//- 

// 

Glasstype: 

OasisScriptPreprocessor 

// 

Derived  from: 

OasisSystem 

// 

Base  for: 

none 

// 

Remarks: 

This  class  provides 

a  mechanism  to  check  source 

// 

//- 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

II 

H 

N 

1 

script  files  errors 

prior  to  use. 

class  OasisScriptPreprocessor  :  private  OasisSystem  {' 
public: 

OasisScriptPreprocessor 0 ;  //  Constructor 

-OasisScriptPreprocessor 0 ;  //  Destructor 

//  Member  functions  for  OasisScriptPreprocessor 
long  PerformErrorChecking (char  *  Source) ; 

II  Reads  script  file  and  displays  to  standard  output  device 
//  of  all  errors  in  script  file. 

OasisScriptPreprocessor*  Instance  () ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

II  Returns  class  identification  string. 

1 ;  //  end  OasisScriptPreprocessor 
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APPENDIX! 

Class  Deflnitions  of  Script  Events  and  Attributes 

//  Classtype:  ObjectHeading 

//  Derived  from:  Event Attribute 

//  Base  for:  VehicleEvent,  WeaponEvent,  EnvironmentEvent 

//  Remarks:  This  class  provides  functions  for  object  headings 

//  in  degrees. 

class  ObjectHeading  :  public  EventAttribute  { 
public; 

ObjectHeading {) ;  //  Constructor 

“ObjectHeadingO ;  //  Destructor 

//  Member  functions  for  ObjectHeading 
void  SetHeading (float  Value); 

//  Assigns  object  heading  in  degrees, 
float  GetHeading 0 ; 

//  Returns  object  heading  in  degrees, 
void  SetHeadingType (char  Type) ; 

//  Assigns  heading  type, 
char  GetHeadingType ( ) ; 

//  Returns  heading  type  as  a  string  (absolute  or  relative)  ,. 
ObjectHeading*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private: 

float  Heading; 

//  Heading  of  object  in  degrees, 
char  HeadingType; 

//  Heading  in  Relative  direction  '  r' 

II  or  Absolute  direction  'a' 

};  II  end  class  ObjectHeading; 


// 

Classtype; 

ObjectVelocity 

// 

Derived  from: 

EventAttribute 

// 

Base  for: 

VehicleEvent,  WeaponEvent,  EnvironmentEvent 

// 

Remarks: 

This  class  provides  functions  for  object  velocity 

// 

//» 

SB' 

in  kilometers  per  hour. 

class  ObjectVelocity  ;  public  EventAttribute  { 
public: 

ObjectVelocity {) ;  //  Constructor 

~ObjectVelocity {) ;  //  Destructor 
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//  Member  functions  for  ObjectVelocity 
float  GetVelocity ( ) ; 

//  Returns  object  velocity  in  km/h. 
void  SetVelocity (float  Value); 

//  Assigns  object  velocity  in  km/h. 
ObjectVelocity*  Instance ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private; 

t  float  Velocity; 

//  Velocity  of  object  in  kilometers  per  hour. 
};  //  end  class  ObjectVelocity; 


// 
1 1 
// 
// 
// 
// 
// 


Classtype; 
Derived  from: 
Base  for: 
Remarks: 


ObjectPitchAngle 

EventAttribute 
VehicleEvent,  WeaponEvent 

This  class  provides  the  functions  for  object  pitch 
angle  in  degrees. 


class  ObjectPitchAngle  ;  public  EventAttribute  { 
public: 

ObjectPitchAngle 0 ;  //  Constructor 

-ObjectPitchAngle {) ;  //  Destructor 

//  Member  functions  for  ObjectPitchAngle 
float  (SetPitchAngle  ( ) ; 

//  Returns  object  pitch  angle  in  degrees, 
void  SetPitchAngle (float  Angle); 

//  Assigns  object  pitch  angle  in  degrees. 
ObjectPitchAngle*  Instance  (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  returns  class  identification  string. 

private: 

float  PitchAngle; 

//  Object's  pitch  angle  in  degrees. 

};  //  end  class  ObjectPitchAngle; 


//  Classtype:  ObjectRoll 

//  Derived  from;  EventAttribute 

//  Base  for:  VehicleEvent 

//  Remarks:  This  class  provides  functions  for  object  roll. 

class  ObjectRoll  :  public  EventAttribute  { 
public: 

ObjectRoll 0 ;  //  Constructor 

-ObjectRoll 0 ;  //  Destructor 
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II  Member  functions  for  ObjectRoll 
float  GetRollAngle ( ) ; 

//  Returns  roll  angle  in  degrees, 
void  SetRollAngle (float  Angle); 

//  Assigns  roll  angle  in  degrees, 
char  *GetRollDirection ( ) ; 

//  Returns  roll  direction  of  either  "port"  or  "stbd" 
void  SetRollDirection (char  *Direction) ; 

//  Assigns  roll  direction. 

ObjectRoll*  Instance  0; 

//  Returns  reference  pointer  of  instance. 
virtual  char  *ClassName 0 ; 

//  Returns  class  identification  string. 

private :  ' 

float  RollAngle; 

//  Roll  angle  of  object  (in  degrees) 
char  *RollDirection; 

//  Direction  of  pitch  (port  or  stbd) 

};  //  end  class  ObjectRoll; 


n 

n 

n 

n 

// 

// 

// 

// 

// 


Classtype: 
Derived  from: 
Base  for: 
Remarks; 


isss^sasssaswaasssssss! 


ObjectComponent 

EventAttribute 

VehicleEvent 

This  class  provides  functions  for  object  component . 
All  movements  of  object  component  ate  represented 
by  the  six  degrees  of  freedom  for  translation  and 
rotation. 


class  ObjectComponent  :  public  EventAttribute  { 
public: 

ObjectComponent 0 ;  //  Constructor 

"ObjectComponent 0 ;  //  Destructor 

//  Member  functions  for  ObjectComponent 
char  *GetCon^onentName ( ) ; 

//  Returns  name  of  object  component, 
void  SetComponentName (char  *Name); 

//  Assigns  name  to  object  coit^onent. 
float  GetComponentRotationdong  Axis); 

//  Returns  component  rotation  in  the  requested  axis, 
void  SetComponentRotation (float  Xval,  float  Yval,  float  Zval); 

//  Assigns  component  rotation  in  the  X,  Y,  and  Z  axis, 
float  GetComponentTranslation (long  Axis); 

//  Returns  component  translation  in  the  requested  axis, 
void  SetComponentTranslation (float  Xval,  float  Yval, float  Zval); 

//  Assigns  component  translation  in  the  X,  Y,  and  Z  axis. 
ObjectComponent*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName 0 ; 

//  Returns  class  identification  string. 
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private: 

ehar  *ComponentNanie; 

//  Component  name  of  object, 
float  ComponentRotation[xyZ] ; 

//  Degrees  of  freedom  in  rotation, 
float  Con^onentTranslation[xyz] ; 

//  Degrees  of  freedom  in  translation. 
);  //  end  class  ObjectComponent; 


// 

Classtype: 

ObjectWeapon 

// 

Derived  from: 

Event Att  r ibute 

// 

Base  for: 

VehicleEvent 

// 

Remar)cs : 

This  class  provides  functions  for  object  weapons 

// 

//- 

Usually  components  on  vehicles. 

class  ObjectWeapon  :  public  EventAttribute  { 
public: 

ObjectWeapon 0 ;  //  Constructor 

“ObjectWeapon () ;  //  Destructor 

//  Member  functions  for  ObjectWeapon 
long  GetWeaponRounds ( ) ; 

//  Returns  number  of  rounds  in  weapon, 
void  SetWeaponRounds (long  Rounds); 

//  Assigns  number  of  rounds  to  weapon, 
chat  *GetWeaponName ( ) ; 

//  Return  name  of  weapon, 
void  SetWeaponName (char  *Nan«) ; 

//  Assigns  name  of  weapon. 

ObjectWeapon*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private: 

char  *WeaponName; 

//  Weapon  con^onent  name, 
long  WeaponRounds; 

//  Number  of  rounds  in  Weapon. 

};  //  end  class  ObjectWeapon 
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//  classtype:  ObjectExpIosion 

//  Derived  from:  Event Attribute 

//  Base  for:  VehicleEvent,  WeaponEvent,  MiscObjectEvent 

//  Remarks:  This  class  provides  functions  for  object  explosions 

class  ObjectExpIosion  :  public  BventAttribute  { 
public : 

ObjectExpIosion 0 ;  //  Constructor 

"Ob jectExplosion {) ;  //  Destructor 

//  Member  functions  for  ObjectExpIosion 
char  *GetExplosionDescription ( )  ; 

//  Returns  description  of  explosion, 
void  SetExplosionDescription (char  ’^Description); 

//  Assign  description  of  object  explosion, 
float  GetExplosionBoundArea (long  Axis); 

//  Return  coordinate  of  explosion  bound  area  along 
//  requested  axis. 

void  SetExplosionBoundArea (float  Xval,  float  Yval,  float  Zval); 

//  Assign  X,  Y,  and  Z  coordinates  of  explosion  bound  area. 
ObjectExpIosion*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private; 

char  *ExplosionDescription; 

//  Descriptive  type  of  explosion, 
float  ExplosionBoundArea [XYZ] ; 

//  Maximum  area  bound  in  X,  Y,  Z  coordinates. 

};  //  end  class  ObjectExpIosion; 


// 

Classtype: 

ObjectFireAndSmoke 

// 

Derived  from: 

BventAttribute 

// 

Base  for: 

VehicleEvent,  WeaponEvent,  MiscObjectEvent 

// 

Remarks; 

This  class  provides  functions  for  all  object  fire 

// 

//= 

and  smoke  events. 

class  ObjectFireAndSmoke  :  public  BventAttribute  { 
public: 

ObjectFireAndSmoke 0 ;  //  Constructor 

“ObjectFireAndSmoke 0 ;  //  Destructor 

//  Member  functions  for  ObjectFireAndSmoke 
char  *GetFireAndSmokeDescription() ; 

//  Returns  descriptive  type  of  smoke  or  fire, 
void  SetFireAndSmokeDescription(char  ‘Description); 

//  Assigns  descriptive  type  of  smoke  or  fire  on  object, 
float  GetFireAndSmokeBoundArea (long  Axis); 

//  Returns  coordinate  of  requested  axis  of  maximum  bound 
//  area  of  smoke  or  fire. 


void  SetFireAndSmokeBoundArea (float  Xval/ float  Yval, float  Zval) 
//  Assigns  coordinates  of  X,  Y,  and  Z  axis  maximum  bound 
//  area  of  smoke  or  fire, 
float  GetFireAndSmokeOffset (long  Axis) ; 

//  Returns  coordinate  of  requested  axis  of  smoke  or  fire 
II  offset  on  object. 

void  SetFireAndSmokeOff set (float  Xval,  float  Yval,  float  Zval); 

//  Assigns  coordinates  of  X,  Y,  and  Z  axis  smoke  or  fire 
//  offset  on  object. 

Ob jectFireAndSmoke*  Instance  ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName ( ) ; 

//  Returns  class  identification  string. 

private: 

char  *FireAndSmokeDescription; 

II  Descriptive  type  of  smoke  or  flame  on  object, 
float  FireAndSmokeBoundArea [XYZ] ; 

//  maximum  area  bound  in  X,  Y,  and  Z  coordinates, 
float  FireAndSmokeOf fset [XYZ] ; 

//  Offset  coordinates  on  object. 

} ;  //  end  class  Ob jectFireAndSmoke; 


//  Classtype:  ObjectTrail 

//  Derived  from:  EventAttribute 

//  Base  for:  VehicleEvent 

//  Remarks:  This  class  provides  functions  for  object  trails. 

class  ObjectTrail  :  public  EventAttribute  { 
public: 

ObjectTrail 0 ;  //  Constructor 

~ObjectTrail 0 ;  //  Destructor 

//  Member  functions  for  ObjectTrail 
char  *GetTrailDescription() ; 

//  Returns  description  of  object  trail, 
void  SetTrailDescription (char  *Description) ; 

//  Assigns  description  to  object  trail, 
float  GetTrailBoundArea (long  Axis) ; 

//  Returns  coordinate  of  trail  bound  area  along  request 
//  axis. 

void  SetTrailBoundArea (float  Xval,  float  Yval,  float  Zval); 

//  Assigns  maximum  bound  area  coordinates  for  X,  Y,  and  Z. 
float  GetTrailOf fset (long  Axis); 

//  Returns  coordinate  of  trail  offset  along  request  axis, 
void  SetTrailOffset (float  Xval,  float  Yval,  float  Zval); 

//  Assigns  object  coordinates  in  X,  Y,  and  Z  for  trail 
//  offset. 

ObjectTrail*  Instance (); 

//  Returns  reference  pointer  of  instance. 
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virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 


private: 

char 

float 

float 

);  //  end 


*TrailDescription; 

//  Descriptive  type  of  object  trail. 
TrailBoundAreatXYZ] ; 

//  Maxitnum  area  bound  of  trail. 
TrailOffset [XY2] ; 

//  Offset  position  on  object, 
class  ObjectTrail; 


//  Classtype:  ObjectFuel 


//  Derived  from: 
//  Base  for: 

/  /  Remar)cs : 

// 

Event Att  ribute 

VehicleEvent 

This  class  provides  functions  for  object  fuel. 

Fuel  is  represented  in  Liters. 

class  ObjectFuel  ; 

public  EventAttribute  { 

public: 

ObjectFuel  () ; 

//  Constructor 

-ObjectFuel 0 ; 

//  Destructor 

//  Member  functions  for  ObjectFuel 


float  GetFuelO; 

//  Returns  amount  of  fuel  in  liters, 
void  SetFuel (float  Value); 

//  Assigns  amount  of  fuel  in  liters. 
ObjectFuel*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName() ; 

//  Returns  class  identification  string. 

private: 

float  Fuel; 

//  Fuel  state  of  Object  (liters) . 

);  //  end  class  ObjectFuel; 


//= 

// 

// 

// 

// 

// 

/ /ssaiKSSSSSSSSSSKBMES 

class  EventObject  : 
public: 

EventObject ()  ; 
-EventObject ()  ; 


Classtype: 
Derived  from: 
Base  for: 

Remarlcs: 


EventObject 

OasisEventObject 

VehicleEvent,  WeaponEvent,  MiscObjectEvent, 
EnvironmentEvent 

This  class  provides  functions  for  all  event  objects 


public  OasisEventObject  ( 


//  Constructor 
//  Destructor 
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//  Member  functions  for  OasisEventObject 
long  ConvertIdFromLongInteger (long  Id); 

/ /  Converts  a  number  to  host  and  object  identification 
//  numbers. 

long  ConvertIdToLongInteger ( )  ; 

//  Returns  number  representing  host  and  object  id  numbers 
long  GetHostNumber { ) ; 

//  Returns  host  number  of  object, 
void  SetHostNumber (long  Number); 

//  Assigns  host  number  for  object, 
long  GetOb jectNumber ( ) ; 

//  Returns  object  identification  number  of  object, 
void  SetOb  jectNumber  (long  Nun±>er) ; 

//  Assigns  object  identification  number  to  object, 
char  *C3et0b  jectDescription  ( )  ; 

//  Returns  object  description, 
void  SetOb jectDescription (char  *Description) ; 

//  Assigns  description  to  object, 
char  *GetObjectStatus 0 ; 

//  Returns  descriptive  status  of  object, 
void  SetOb jectStatus (char  *Status); 

//  Assigns  descriptive  status  of  object. 

EventObject*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  returns  class  identification  string. 

private : 

long  ObjectHostNumber; 

//  Host  identification  number  of  object, 
long  ObjectNumber; 

//  Object  identification  number, 
char  *ObjectDescription; 

/ /  Description  type  of  object . 
char  *ObjectStatus; 

//  Descriptive  status  of  object. 

);  //  end  EventObject 


//  Classtype: 

//  Derived  from: 
//  Base  for: 

//  Remarks: 

// - - - - 


WeaponSource 

EventAttribute 

WeaponEvent 

This  class  provides  functions  for  weapon  source. 


class  WeaponSource  :  private  EventAttribute  { 
public: 

WeaponSource 0 ;  //  Constructor 

'■WeaponSource  () ;  //  Destructor 
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/ /  Member  functions  for  WeaponSource 
EventObjectS  GetWeaponSourceO ; 

//  Returns  source  object  of  weapon, 
void  SetWeaponSource (EventOb jects  Source) ; 

//  Assigns  source  obje''t  of  weapon. 
WeaponSource*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName {) ; 

//  Returns  class  identification  string. 

private: 

EventObject  SourceOf Weapon; 

//  Source  object  assocated  with  weapon. 

);  //  end  class  WeaponSource 


//  Classtype:  TimeStamp 

//  Derived  from:  OasisEventOb ject 
//  Base  for:  ScriptEvent 

//  Remarks:  This  class  provides  functions  for  all  timestamps 

class  Timestamp  :  public  OasisEventObject  { 
public: 

Timestamp () ;  //  Constructor 

"TimeStan^  ( ) ;  //  Destructor 

//  Member  functions  for  TimeStamp 
void  SetHours (long  Value) ; 

//  Assigns  hours  in  timestamp, 
long  GetHoursO; 

//  Returns  hours  in  timestam.p. 
void  SetMinutes (long  Value) ; 

//  Assigns  minutes  in  timestamp, 
long  GetMinutes  0 ; 

//  Returns  minutes  in  timestamp, 
void  SetSeconds (long  Value) ; 

//  Assigns  seconds  in  timestamp, 
long  GetSeconds 0 ; 

//  Returns  seconds  in  timestamp, 
void  SetMicroseconds (long  Value); 

//  Assigns  microseconds  in  timestamp, 
long  GetMicroseconds () ; 

//  Returns  microseconds  in  timestamp, 
long  StringToTimestan^i  (char  *Timestring) ; 

//  Converts  timestanp  string  to  hours,  minutes,  seconds, 

//  and  microseconds, 
char  *TimestampToString ( ) ; 

//  Returns  timestamp  as  a  string. 

TimeStamp*  Instance ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 
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private: 

long 

Hours; 

long 

//  Timestamp  hours. 

Minutes; 

long 

//  Timestamp  minutes. 

Seconds; 

long 

//  Timestamp  seconds. 
Microseconds; 

char 

//  Timestamp  microseconds. 
*TimeString; 

) ;  II  end 

//  Timestamp  in  string  format, 
class  Timestamp 

//= 

// 

Classtype: 

EventPosition 

// 

Derived  from: 

OasisEventObject 

// 

Base  for: 

ScriptEvent 

// 

Remar)cs: 

This  class  provides  functions  for  UTM  coordinates 

// 

//= 

II 

II 

II 

II 

N 

II 

II 

II 

II 

II 

It 

It 

II 

II 

II 

and  ele/ations. 

class  EventPosition  :  public  OasisEventObject  { 
public: 

EventPosition {) ;  //  Constructor 

“EventPosition <) ;  //  Destructor 

//  Member  functions  for  EventPosition 
void  SetGridzone (char  *NewGridzone) ; 

//  Assigns  gridzone  of  UTM  position 
char  *GetGridzone ( ) ; 

//  Returns  gridzone  of  UTM  coordinates, 
void  SetMgrs(char  *NewMgrs); 

//  Assigns  MGRS  of  UTM  coordinates, 
char  ‘GetMgrsO; 

//  Returns  MGRS  of  UTM  coordinates, 
void  SetNorthing (long  Value) ; 

//  Assigns  Northing  of  UTM  coordinates, 
long  (SetNorthing  ( )  ; 

//  Returns  Northing  of  UTM  coordinates, 
void  SetEasting (long  Value) ; 

//  Assigns  Easting  of  UTM  coordinates, 
long  GetEasting ( ) ; 

//  Returns  Easting  of  UTM  coordinates, 
void  SetElevation (float  Value); 

//  Assigns  elevation, 
float  GetElevationO  ; 

//  Returns  elevation. 

long  StringToUtmPosition(char  *Position,  char  *defaultGZ, 

char  *defaultMGRS) ; 

! !  Extracts  UTM  coordinates  from  Position,  and  returns  null 

//  if  error  occurs.  Default  gridzone  and  mgrs  are  required 

//  for  UTM  defaults. 
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long  StringToMap{char  *inap_strg,  char  *defaultGZ, 

char  *defaultMGRS) ; 

//  Extracts  default  UTM  gridzone  and/or  Mgrs/  and  returns 
//  null  if  error  occurs, 
char  *Ut:rl^ositicnToStrir.g  ()  ; 

//  Returns  UTM  coordinates  as  a  string. 

EventPosition*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassKame () ; 

//  Returns  class  identification  string. 

private: 

char  *Gridzone; 

//  grid  zone  of  UTM  coordinate  system 
char  *Mgrs; 

//  mgrs  of  UTM  coordinate  system 
long  Northing; 

//  northing  offset  of  grid  zone 
long  Easting; 

//  easting  offset  of  grid  zone 
float  Elevation; 

//  altitude 
chat  *PositionString; 

//  UTM  coordinates  in  string  format 
J;  //  end  class  EventPosition; 


j  y  a=s3«a&s&sassssBasatflt*BSsssss3B3Baisss3ssa:ass3SVMKS£sassss:s;=sKBK±sasssssssBBS3s«fliKss±aKssss=ssss:sss 

//  Classtype:  ScriptEvent 

//  Derived  from:  EventObject,  EventPosition,  EventAttribute, 

//  Timestamp 

//  Base  for:  VehicleEvent,  WeaponEvent,  MlscOb jectEvent, 

//  EnvironmentEvent,  ScriptCommjnt,  ScriptOption 

//  Remarks:  This  class  is  the  base  for  all  script  events.  Each 

//  script  event  must  have  an  object,  place,  and  time. 

class  ScriptEvent  :  public  EventObject,  public  EventPosition, 

private  EventAttribute,  public  TimeStamp  { 

public: 

ScriptEvent () ;  //  Constructor 


~ScriptEvent () ; 


//  Destructor 


//  Member  functions  for  ScriptEvent 


long  GetEventType ( ) ; 

//  Returns  type  of  script  event, 
void  SetEventType (long  Type); 

//  Assigns  type  of  script  event, 
char  •GetEventResult {) ; 

//  Returns  descriptive  result  of  event, 
void  SetEventResult (char  ‘Result); 

//  Assigns  descriptive  result  of  event. 
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ScriptEvent*  Instance ( ) ; 

//  Returns  reference  pointer  to  instance, 
virtual  char  *ClassName {) ; 

U  Returns  class  identification  string. 

private: 

long  Event Type; 

//  Type  of  script  event, 
char  *EventResult; 

//  Description  result  of  event. 

};  //  end  class  ScriptEvent 


// - - 

//  Classtype: 

//  Derived  from: 
// 

// 

// 

//  Base  for: 

//  Remarks: 


(■••asMaBawMteSBssKBBBsssBBaBSBBssasasBSSBBssBaiassBssasMXSssssssaiflE 

VehicIeEvent 

ScriptEvent,  ObjectHe  ling,  ObjectVelocity, 
ObjectPitchAngle,  ObjectRoli,  Ob jectComponent, 
ObjectWeapon,  ObjectExplosion,  ObjectFireAndSmoke, 
ObjectTrail,  ObjectFuel 
ScriptOL  .  zt 

This  class  is  for  all  vehicle  events. 


class  VehicIeEvent  :  public  ScriptEvent,  public 

public  ObjectVelocity,  public 

public  ObjectPitchAngle,  public 

public  Ob jectComponent,  public 

public  ObjectFireAndSmoke,  public 

public  ObjectExplosion  { 

public; 

VehicIeEvent  {) ;  //  Constructor 

-VehicIeEvent 0 ;  //  Destructor 

//  Member  functions  for  VehicIeEvent 
VehicIeEvent*  Instance ( ) ; 

/ /  Returns  reference  pointer  of  instance 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

);  //  end  class  VehicIeEvent 


Ob jectHeading, 

ObjectFuel, 

ObjectRoll, 

ObjectWeapon, 

ObjectTrail, 


//  Classtype: 

//  Derived  from; 

II 

II 

II  Base  for: 

//  Remarks: 

class  WeaponEvent 


WeaponEvent 

ScriptEvent,  WeaponSource,  Ob jectHeading, 
ObjectPitchAngle, 

ObjectVelocity,  ObjectExplosion 
ScriptObject 

This  class  is  for  all  Weapon  events. 

:  public  ScriptEvent,  public  WeaponSource, 
public  ObjectHeading,  public  ObjectPitchAngle, 
public  ObjectVelocity,  public  ObjectExplosion  { 
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public: 

WeaponEvent ( ) ;  //  Constructor 

-WeaponEvent ( ) ;  //  Destructor 

//  Member  functions  for  WeaponEvent 
WeaponEvent*  Instance  ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string, 

) ;  //  end  class  WeaponEvent 


//== - ===== - - 

//  Classtype: 

//  Derived  from: 
//  Base  for: 

//  Remarks: 

/ / ================ 


MiscObjectEvent 

ScriptEvent,  Ob jectFireAndSmoke,  Ob jectExplosion 
ScriptObject 

This  class  is  for  all  miscellaneous  object  events. 


class  MiscObjectEvent  ;  public  ScriptEvent,  public  Ob jectFireAndSmoke, 

public  Ob jectExplosion  { 

public: 

MiscObjectEvent () ;  //  Constructor 

-MiscObjectEvent () ;  //  Destructor 

//  Member  functions  for  MiscObjectEvent 
MiscObjectEvent*  Instance ( ) ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName <) ; 

//  Returns  class  identification  string. 

};  //  end  class  MiscObjectEvent 


//  Classtype: 

//  Derived  from: 

//  Base  for: 

/ /  Remarks : 

class  EnvironmentEvent 


EnvironmentEvent 

ScriptEvent,  Ob jectHeading,  ObjectVelocity 
ScriptObject 

This  class  provides  is  for  all  environment  events. 


public  ScriptEvent,  public  Ob jectHeading, 
public  ObjectVelocity  { 


public: 

EnvironmentEvent 0 ;  //  Constructor 

-EnvironmentEvent () ;  //  Destructor 

//  Member  functions  for  EnvironmentEvent 
EnvironmentEvent*  Instance () ; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

);  //  end  class  EnvironmentEvent 
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//  Classtype: 

//  Derived  from: 
//  Base  for: 

//  Remarks: 


ScriptComment 

ScriptEvent 

ScriptObject 

This  class  provides  functions  for  script  comments. 


//  Pointer  to  comment  line. 

//  Pointer  to  next  comment  line. 


//  Constructor 
//  Destructor 


class  ScriptConment  :  public  ScriptEvent  { 

//  Data  structure  for  each  comment  line 
typedef  struct  CommentPointer  { 
char  *Line; 

struct  CommentPointer  *Next; 

)  CommentLink; 
public: 

ScriptComment {) ; 

~ScriptComment () ; 

//  Member  functions  for  ScriptComment 

long  ReadFromFile (FILE  *InputFile,  char  *Line) ; 

//  Reads  from  script  file  rest  of  comment  block.  Prior  to 
//  function  call,  first  script  line  is  already  read, 
void  DeleteComment () ; 

//  Removes  all  comment  lines  in  comment  block, 
long  GetNumberOfCommentLines 0 ; 

//  Returns  number  of  lines  in  comment  block. 

CommentLink  *GetCommentBlock () ; 

//  Returns  reference  pointer  to  comment  block, 
void  SetCommentBlock (CommentLink  *Block) ; 

//  Assigns  reference  pointer  to  comment  block. 
ScriptComment*  InstanceO; 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private: 

long  NutrberOfCommentLines; 

//  Number  of  lines  in  comment  block, 

CommentLink  *Comment; 

//  Reference  pointer  to  next  comment  line. 

};  //  end  class  ScriptComment 
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//  Classtype: 

//  Derived  from: 
//  Base  for: 

//  Remarks: 

// 

//========.====^= 


ScriptOption 
ScriptEvent 
Script  Object 

This  class  provides  functions  for  parameters 
associated  with  script  options. 


class  ScriptOption  :  public  ScriptEvent  { 
public: 

ScriptOption 0 ;  //  Constructor 

“ScriptOption 0 ;  II  Destructor 
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//  Member  functions  for  Script Option 
double  GetScriptTimeFactor () ; 

//  Returns  script  time  factor, 
void  SetScriptTimeFactor (double  Factor); 

//  Assigns  script  time  factor, 
double  GetScriptTimeAdjustment () ; 

//  Returns  script  time  adjustment, 
void  SetSoriptTimeAdjustment (double  Adjustment); 

//  Assigns  script  time  adjustment, 
char  *GetDelayType ( ) ; 

//  Returns  script  delay  type.  'K 

void  SetDelayType (char  *Type); 

II  Assigns  script  delay  type. 

char  *GetTimeReference 0  ;  ' 

II  Returns  script  time  reference, 
void  SetTimeReference (char  *Reference); 

//  Assigns  time  reference  for  assigning  script  timestamps, 
char  *GetScriptLine  0 ; 

//  Returns  script  line  or  message, 
void  SetScriptLine (char  *Line) ; 

II  Assigns  script  line  or  message, 
char  *GetScriptFilename ( ) ; 

//  Returns  filename  of  script  file, 
void  SetScriptFilename (char  *Name) ; 

//  Assigns  filename  of  script  file, 
long  GetScriptRepeatValue  0 ; 

//  Returns  script  repeat  value  of  iterations, 
void  SetScriptRepeatValue (long  value); 

//  Assigns  script  repeat  value  of  iterations, 
long  GetScriptObjectNumberIncrement  0 ; 

//  Returns  script  object  no.  increment, 
void  SetScriptObjectNumberIncrement (long  Value); 

//  Assigns  script  object  number  increment. 

ScriptOption*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  string. 

private : 

char  *DelayType; 

//  Delay  type  in  relative  or  absolute, 
char  *TimeReference; 

//  Time  reference  in  relative  or  absolute, 
char  *ScriptLine;  * 

//  Reference  pointer  for  scripo  line  or  message, 
char  *ScriptFilename;  ^ 

//  Filename  of  script  file, 
long  RepeatValue; 

//  Number  of  repeats  for  script  file, 
long  Ob jectNumberIncrement; 

//  Object  number  increment  for  each  iteration. 
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double  TimeFactor; 

//  Time  factor  for  computing  timestamps, 
double  TimeAdjustment; 

//  Time  adjustment  for  computing  timestamps., 
) ;  //  end  class  ScriptOption 


i 

\ 


k 
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APPENDIX  J 

Class  Definition  of  ScriptObject 


//= 

// 

Classtype : 

ScriptObject 

// 

// 

Derived  from: 

VehicleEvent,  WeaponEvent,  MiscObjectEvent, 
EnvironmentEvent,  ScriptOption,  ScriptComment 

// 

Base  for: 

none 

// 

Remarks : 

This  class  provides  functions  for  accessing  script 

// 

//= 

events . 

class  ScriptObject  :  public  VehicleEvent/ 

public  WeaponEvent, 
public  MiscOb jectEvent, 
public  EnvironmentEvent, 
public  ScriptOption, 
public  ScriptComment  { 

public: 

ScriptObject 0 ;  //  Constructor 

~ScriptObject 0 ;  //  Destructor 

//  Member  functions  for  ScriptObject 
long  GetScriptEventType () ; 

//  Returns  type  of  script  event, 
void  SetScriptEventType (long  Type); 

//  Assigns  type  of  script  event. 
VehicleEventS  GetVehicleEvent {) ; 

//  Returns  reference  of  vehicle  event. 
WeaponEventS  GetWeaponEvent ( ) ; 

//  Returns  reference  of  weapon  event. 
MiscObjectEventfi  GetMiscObjectEvent () ; 

//  Returns  reference  of  misc  object  event. 
EnvironmentEvent &  GetEnvironmentEvent {) ; 

//  Returns  reference  of  environment  event. 
ScriptOptionS  GetScriptOption {) ; 

//  Returns  reference  of  script  option. 
ScriptCommentS  GetScriptComment () ; 

//  Returns  reference  of  script  comment. 
ScriptObject*  Instance (); 

//  Returns  reference  pointer  of  instance, 
virtual  char  *ClassName () ; 

//  Returns  class  identification  .string. 

private: 

long  ScriptEventType; 

//  Type  of  event  for  script  object. 

);  //  end  class  ScriptObject 


APPENDIX  K 

NPSNET-OASIS  Network  Interface 


« 

V 
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The  following  NPSNET  data  structure  is  used  for  sending  vehicle  updates  over  the  net. 
Attributes  marked  with  an  asterisk  are  used  in  the  vehicle  update  message  packet. 

struct  vehpostype  { 

int  vehtype;  * 

int  control;  * 

int  gunfire;  * 

int  alive;  * 

int  rounds ; 

int  deadframes; 

int  coll_interval; 

float  pos [3] ,  * 

eye[3] , 
lookatpt [3] , 
lookfrompt [3] ; 

float  direction,  * 

viewdirection,  * 

elev,  * 

gunelev,  * 

speed,  * 

roll, 
pitch, 
gas, 

coll_range; 

};  //  end  structure 


The  following  is  an  example  of  the  transformation  of  a  VEHICLE_ACTIVATE  script 
event  to  a  data  structure  in  the  local  state  of  the  world  in  NPSNET-OASIS  network 
interface. 


vehicle [Number] .vehtype  = 

Vehicle [Number] . control  = 

Vehicle [Number] .gunfire  = 

Vehicle [Number] .alive  = 

Vehicle [Number] . rounds  “ 

Vehicle [Number] .deadframes  = 
vehicle [Number] .coll_interval  = 
Vehicle [Number] .pos [X]  = 

Vehicle [Number] .pos [Z]  = 

Vehicle [Number] .elev  = 

Vehicle [Number] .eye [X]  = 


LookForOb jectTypeNumber ( 

ScriptEvent .GetObjectDescription  0 ) 
SCRIPTED; 

0; 

TRUE; 

DEFAULT_VEHICLE_ROUNDS ; 

0; 

0; 

ScriptEvent . GetEasting { ) ; 
MAX_UTM_NORTHING  - 
ScriptEvent .GetNorthing 0 ) ; 
ScriptEvent . GetElevation ( ) ; 

0.0; 
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Vehicle [Number] .eye[Y] 

Vehicle [Number] .eye [2] 

Vehicle [Number] .lookatpt[X] 
Vehicle [Number] .lookatpt[Y] 
Vehicle [Number] .lookatpt[Z] 
Vehicle [Number] .lookfrompt [X] 
Vehicle [Number] .lookfrompt [Y] 
Vehicle [Number] . lookfrompt [2] 
Vehicle [Number] .direction 
Vehicle [Number] . viewdirection 
Vehicle [Number] .elev 
Vehicle [Number] .gunelev 
Vehicle [Number] .speed 
Vehicle [Number] .roll 
Vehicle [Number] .pitch 
Vehicle [Number] .gas 
Vehicle [Number] .coll_range 


=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 

=  0.0; 

=  ScriptEvent.GetHeadingO  ; 

=  0.0; 

=  ScriptEvent . GetElevation  { ) ; 

=  0.0; 

=  ScriptEvent . GetVelocity ( ) ; 

=  0.0; 

=  0.0; 

=  DEFAULT_VEHICLE_GAS, 

=  0.0; 


I 


» 
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